File No. S370-36 
Order No. GC20-1820-0 



Systems 



IBM Virtual Machine 

Facility/370: 

CP Command Reference 

for General Users 



Release 3 PLC 1 

This publication is a reference manual for the 
general class of users that are running systems 
such as OS, DOS, OS/VS, DOS/VS, CMS, and 
RSCS in a virtual machine under VM/370. 

Each CP command available to the general class 
of user is listed alphabetically and contains general 
usage information, the command line format, 
descriptions of all operands and options, allowable 
values for operand variables, and default values 
for optional operands. Also included are tables 
showing the relationship of the general class of 
CP commands to the entire set of VM/370 
commands. 

Prerequisite Publications 

IBM Virtual Machine Facility/370: 

Operating Systems in a Virtual Machine, 

Order No. GC20-1821 

Terminal User's Guide, Order No. GC20-1810 



.]3Jy iMi 



ZiE§t Edition (February 1976) 

This edition corresponds to Release 3 £LC \ (Program Level Change) of 
IBM Virtual Machine Facility/370, and to all subsequent releases unless 
otherwise indicated in new editions or Technical Newsletters- 
Changes are periodically made to the specifications herein; before using 
this publication in connection with the operation of IBM systems, 
| consult the latest IBM Sistem^370 Bibliogr ap_h;y_ , Order Wo. GC20-0001, for 
the editions that are applicable and current. 

Bequests for copies of IBM publications should be made to your IBM 
representative or to the IBM branch office serving your locality. 

A form for readers' comments is provided at the back of this 
publication. If the form has been removed, comments may be addressed to 
IBM Corporation, VM/370 Publications, 24 New England Executive Park, 
Burlington, Massachusetts 01803. Comments become the property of IBM. 

© Copyright International Business Machines Corporation 1976 



Preface 



This publication is a reference manual that 
discusses VM/370 CP commands available to 
the general user. 

With these commands, the general user 
can reconfigure his virtual machine, 
control devices attached to his virtual 
machine, perform input and output spooling 
functions, and simulate many other 
functions of a real computer console. 

Other VM/370 CP commands, available only 
to system operators, system programmers and 
analysts, and service representatives, are 
described in the publications: 

ISU Virtual Machine Faci lit y/3 7 : 

0£§£ii2£l§ Guide, Order No. GC20-1806 

System Programmer's Guide, Order No. 
GC20-1807 

OLTSEP and Error Recording Guide, Order 
No. GC20-1809 

This publication is organized in two 
parts: "Part 1: General Information" and 
"Part 2: Reference Information." 

Part 1 has three sections: 

"Section 1 . Introduction and General 
Concepts" is a summary of the concepts you 
should be familiar with when you are using 
VM/370. 

"Section 2. The VM/370 Command 
Languages" describes the VM/370 command 
environments, the general structure of the 
command languages, and command truncation 
and abbreviation. 

"Section 3. The CP Command Language" 
provides additional information on the CP 
subset of VM/370 commands. 

Part 2 has two sections: 

"Section 4. Notational Conventions" 
describes the syntax that is used in this 
publication to display command formats. 

"Section 5. Format of CP Commands" 
contains reference data for all the Class G 
and Any commands in alphabetical seguence 
by command name. The command line format 
includes all operands along with a 
description of each. Any limits or 



restrictions applicable to the values of 
variable operands are also defined. 

"Appendix A: VM/370 Command Summary" 
contains all the VM/370 commands, by VM/370 
component, with a brief description of each 
command 1 s function. This is intended to 
give the general user a perspective of the 
position that the CP class G and class Any 
commands occupy in the overall VM/370 
command structure. 

In this publication, the following 
terminology is used: 

• 2305 refers to the IBM 2305 Fixed Head 
Storage, Models 1 and 2. 

• 3270 refers to both the IBM 3275 Display 
Station, Model 2 and the IBM 3277 
Display Station, Model 2. 

• 3330 refers to the IBM 3330 Disk Storage 
Models 1, 2, 11; the IBM 3333 Disk 
Storage and Control Models 1 and 11; and 
the 3350 Direct Access Storage operating 
in 3330/3333 Model 1 or 3330/3333 Model 
2 compatibility mode. 

• 3340 refers to the IBM 3340 Disk 
Storage, Models A2, B1 and B2; and, the 
3344 Direct Access Storage, Model B2. 

• 3350 refers to the IBM 3350 Direct 
Access Storage, Models A2 and B2, in 
native mode. 

Any information pertaining to the IBM 2741 
terminal also applies to the IBM 3767 
terminal, Model 1, operating as a 2741, 
unless otherwise specified. 

Information on the IBM 3344 Direct 
Access Storage Device and the IBM 3350 
Direct Access Storage contained in this 
publication is for planning purposes only 
until the availability of the product. 

For a glossary of VM/370 terms, see the 
IBM Virtual Machine F acility/3 7 : Glossary 
and Master Index, Order No. GC20-1813. 



PREREQUISITE PUBLICATIONS 

The IBM Virtual .Machine Facility/370: 
0£6JE§iil!3 Systems in a Virtual Machine, 



Order No. GC20-1821, provides functionally 
organized usage information and examples 
pertaining to the class G and Any CP 
commands, as well as the other classes of 
CP commands. 

The physical operation of the virtual 

machine console is covered in the IB.U 

YiEtMi Machine Facility./ 37 : Terminal 
User^s Guide, Order No. GC20-1810. 



If the IBM 3767 Communications Terminal 
is to be used as a virtual console, the 
publication IBM 3767 9_E§£atorJ.s Guide, 
Order No. GA18-2000, is a prerequisite. 



COREQOISITE PUBLICATIONS 



Error messages that may be issued to a user 
during a terminal session are fully 



documented in IBM Virtual Machine 
lacil i ty/3 7 : System Messages, Order No. 
GC20-1808. 

General users intending to run CMS or 
RSCS will find the respective command 
languages documented in the following 
publications : 

IBM Virtual Machine Faci li ty/37 : 

CMS UserJ.s Guide, Order No. GC20-1819 

SUS Command and Macro Reference, Order 
No. GC20 = 1818~ 

leJ5o£e S|>oolinc[ Communications 

Subsystem (RSCS) User^s Guide, Order 
No7 GC20-1816 

References in text to titles of 
prerequisite and corequisite VM/370 
publications will be given in abbreviated 
form. 
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Part 1. General Information 



This part of the publication contains general information about the 
VM/370 system. It contains three sections. 

"Section 1. Introduction and General Concepts" is a summary of the 
concepts you should be familiar with when you are using VM/370. 

"Section 2. The VM/370 Command Language" describes the VM/370 command 
environments, the general structure of the command languages, and 
command truncation and abbreviation. 

"Section 3. The CP Command Language" provides additional information 
on the CP subset of VM/370 commands. 
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Section 1. Introduction and General Concepts 



Virtual Machine Facility/370 

Virtual Machine Facility/370 (VM/370) is a system control program (SCP) 
that manages a real computing system so that its resources (CPU, 
storage, and input/output devices) are made available to many users. 
The sharing of these resources is performed in such a way that each user 
appears to have all the facilities required to accomplish his task. 
Each user has at his disposal the functional equivalent of a real, 
dedicated computing system. Because this functional equivalent is 
simulated for the user by VM/370 and does not really exist, it is called 
a virtual machine. 

VM/370 has four components: the Control Program (CP) , the 
Conversational Monitor system (CMS) , the Remote Spooling Communications 
Subsystem (RSCS) , and the Interactive Problem Control System (IPCS) . CP 
controls the resources of the real machine to provide an environment in 
which multiple virtual machines can exist. CMS, a subsystem of VM/370, 
runs in a virtual machine and provides conversational time-sharing 
facilities such as the creation and management of files, and the 
compilation, testing, and execution of problem programs. RSCS, another 
subsystem of VM/370, also runs in a virtual machine and provides users 
with the facility to transmit files to and receive files from remote 
stations. IPCS provides VM/370 problem analysis and problem management 
facilities. This includes the creation of problem reports, tracking of 
problems, and an online CP dump analysis. 



VM/370 Control Program 

The VM/370 Control Program (CP) has at its disposal only a finite amount 
of real CPU time, real storage, and real input/output devices. Using 
techniques such as time slicing, paging, and spooling, CP manages these 
resources so that each virtual machine appears to have the resource it 
needs, at the time it needs it. 



TIME MANAGEMENT 

Time slicing is a technique by which each virtual machine is 
periodically allowed access to the real CPU for an increment of time 
called a time slice. A scheduling algorithm, or set of rules, in CP 
controls the access to the real CPU based on the virtual machine's type 
of operation, readiness for execution, and assigned priority. 



STORAGE MANAGEMENT 

Paging is a technique used by CP to distribute the available real 
storage to the virtual machines that are executing. Regardless of the 
actual size of virtual storage, only those areas (pages) that are 
currently being referenced are kept in real storage. The rest of 
virtual storage resides on some direct access storage device (DASD) . As 
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the virtual machines alternate usage of the real CPU and as different 
parts of a program are executed, pages of virtual storage are shuttled 
between real storage and DASD. 



VIRTUAL I/O MANAGEMEMT 

The virtual machine operating system is responsible for the operation of 
all virtual devices associated with it, except for spooled devices as 
described below. CP is responsible for the interface between the 
virtual devices and their real counterparts. Under CP, a real device 
also may be dedicated to a virtual machine. There would then be a 
direct one-to-one correspondence between a virtual device and an 
equivalent real device. Real devices may also be shared, where multiple 
virtual machines have controlled accessibility to one real device. 

CP spooling facilities allow multiple virtual machines to share the 
real unit record devices. Virtual unit record devices that have been 
designated as spooled are controlled by CP. The data being moved is 
re-formed by CP into page-sized records (4096-byte blocks) and stored in 
a VM/370 DASD area. This area serves as intermediate storage between 
the virtual machine and the real unit record device. Input spool files 
are made available to designated virtual card readers. Output spool 
files are scheduled for the real printer or punch whenever the files are 
closed or when the user logs off the system. 
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Section 2. The VM/370 Command Languages 



Each of the components of VM/370 has its own command language. The CP 
command language is described in this publication and in the VM/370: 
°.Ee£ating Systems in a Virtual Machine. The CMS command language is 
described in the VM/370: CMS User's Guide and VM/370: CMS Command a.nd 
Macro Reference. The RSCS command language is described in the VM/370: 
Remote Spooling Communications Subsystem (RSCS) User's Guide. The IPCS 
command language is described in the VM/370: Interactive J?io|)lem Control 
System (IPCS) User's Guide. 

This section describes the VM/370 command environments, the general 
structure of the CP, CMS and RSCS command languages, and the command 
abbreviations and truncations. 

There are two types of VM/370 commands: system commands and 
user-defined commands. The system commands are those defined by the CP, 
CMS and RSCS command languages. User-defined CMS commands are those you 
can create yourself using the EXEC command or the LOAD and GENMOD 
commands. The procedure for creating user-defined CMS commands is 
described in the VM/370: CMS User's Guide. User-defined CP commands are 
also allowed; however, your installations system programmer must create 
them. The procedure for creating user-defined CP commands is described 
in the VM/370: System Programmer's Guide. 



VM/370 Command Environments 

There are two basic command environments: the Control Program (CP) 
command environment and the virtual machine command environment. 

You are in the Control Program (CP) command environment when you log 
on to VM/370 and issue CP commands. 

You are in the virtual machine command environment when you load your 
virtual machine with CMS or other operating system. 

If you are operating under CMS, you can determine which command 
environment you are in by entering a null line (that is, pressing the 
Enter key, or eguivalent, with no data). VM/370 responds to a null line 
by displaying the current command environment, CMS or CP. 



INTERRUPTING THE EXECUTION OF A COMMAND 

Using the Attention key, you can switch command environments (that is, 
switch from the CP to the virtual machine command environment or vice 
versa) , at the same time that you reguest an interruption. 

Each of the terminals that can be used with the VM/370 system has a 
key that is the eguivalent of the Attention key on the 2741 (with which 
you signal an attention interruption) . Unless otherwise noted, where 
the term "Attention key" is used in this publication, the phrase "(or 
eguivalent) " is implied. 

The name and physical location of the Attention key varies with 
different styles of terminals supported by VM/370. See the VM/370: 
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Terminal User^s Guide for details on various styles of terminals. What 
actually happens when you press the Attention key depends on three 
factors: the command environment of your virtual machine, the mode 
setting of your terminal, and the number of times the Attention key is 
pressed. 

The commands you issue determine the command environment of your 
virtual machine; you are either issuing CP commands or some virtual 
machine operating system commands. 

The mode of your terminal is set via the CP TERMINAL command. The 
MODE operand of this command allows you to set your terminal in either 
the CP or VM mode. How CP interprets attention interruptions issued by 
the virtual machine users depends on whether the terminal mode is set to 
CP or VM. 

VM is the default mode setting for all VM/370 users except the 
primary system operator whose default mode is CP. To enter CP terminal 
mode, enter: 

TERMINAL MODE CP 

If your default terminal mode is CP, or if you issued the above 
command, pressing the Attention key one or more times forces your 
virtual machine into CP mode. 

To return to the VM terminal mode, enter: 

TERMINAL MODE VM 

If the terminal mode is VM, pressing the attention key once passes an 
interruption pending condition to the virtual machine operating system. 
Pressing the Attention key twice guickly (or pressing the 3270's PA1 
key) places your virtual machine in CP mode. 

If you execute CMS from a 3270 device, you may issue the ATTN or 
REQUEST command if you are in CP mode and want to return to the virtual 
machine with an attention interrupt. Pressing the Attention key (or the 
PA1 key for a 3270) will have the same effect. To return to the virtual 
machine, issue the BEGIN command. 

Figures 1 and 2 show the effect of an attention interrupt when your 
terminal is in either" VM or CP mode. Figure 1 shows the action taken by 
VM/370 when your terminal is in VM mode and you press the Attention 
key. The first column represents the state of the terminal keyboard 
when you press the Attention key. The second column represents the 
number of times you press the Attention key. If your terminal is in the 
VM mode, one attention requests an interrupt and two quick attentions 
force your virtual machine to the CP command environment. The third 
column represents the action VM/370 takes, depending on the number of 
times you press the Attention key. 

Note: If the operator sets his terminal mode to VM and resets his 
virtual machine, his console acts; as described in the first state of 
Figure 1 (that is, more than one attention is required to unlock the 
keyboard for CP input) . 
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State 



Terminal idle; keyboard 
entry blocked; virtual 
machine running 



Terminal receiving output 
from virtual machine 



Keyboard activated for 

input to virtual machine; 
no data entered or all 
data deleted 



Keyboard activated for 

input to virtual machine; 
some data entered 



Keyboard entry blocked; 
executing CP command 

Keyboard entry blocked; in 
SLEEP mode entered via 
command 

Keyboard entry blocked; in 
SLEEP mode entered via 
Diagnose instruction 

Terminal receiving output 
from CP but not from user 
command 



Terminal receiving output 
in response to CP command 



Keyboard activated for CP 
input; no data entered or 
all data cancelled 



Keyboard activated for CP 
input; some data entered 



Press 

ATTN 

Key 



1 

>1 
1 

>1 



>1 



>1 



1 or 
>1 

1 or 
>1 



1 or 
>1 



>1 



1 or 
>1 



1 or 
>1 



1 or 
>1 



Action 



Attention interruption pending; 
virtual machine running 

Keyboard activated for CP input 

Attention interruption pending; 
virtual machine running 

Keyboard activated for CP input at 
completion of console I/O 

Device end (DE) and attention status 
pending; virtual machine running 

Unit exception (UE) status pending; 
keyboard activated for CP input 



Unit exception (UE) status pending; 
virtual machine running 



Device end (DE) status pending; 
keyboard activated for CP input 

Attention ignored 

Keyboard activated for CP input 

Virtual machine resumes execution 



Attention interruption pending; 
virtual machine running 

Keyboard activated for CP input 



Output line cancelled and in some 
cases command output cancelled 



Attention interruption made pending; 
virtual machine running 



Input line cancelled; keyboard 
activated for CP input 



Figure 1. Attention Handling in VM Mode 
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Figure 2 shows the action taken by VM/370 when your virtual console 
is in CP mode. If your virtual console is in CP mode and you press the 
Attention key one or more times, you force the virtual machine to the CP 
command environment. 



| State 

I 

| Terminal idle; keyboard entry 
| blocked; virtual machine 
| running 

| Terminal receiving output from 
| virtual machine 



Keyboard activated for input to 
| the virtual machine; no data 
| entered or all data deleted 

| Keyboard activated for input to 
| virtual machine; some data 
I entered 

| Keyboard entry blocked; 
t executing CP command 

I Keyboard entry blocked; in SLEEP 
1 mode entered via command 

|| Keyboard entry blocked; in SLEEP 
| mode entered via Diagnose 
i instruction 

1 Terminal receiving output from 
| CP but not from user command 

| Terminal receiving output in 
| response to CP command 



| Keyboard activated for CP input; 

I no data entered or all data 

II cancelled 



Action 
Keyboard activated for CP input 

Keyboard activated for CP input 



Unit exception (OE) status pending; 
keyboard activated for CP input 



Device end (DE) status pending; 
keyboard activated for CP input 



Attention ignored 

Keyboard activated for CP input 



Virtual machine resumes execution 



Keyboard activated for CP input 



Output line cancelled and in some 
cases command output cancelled 



Attention interruption made pending; 
virtual machine running 



| Keyboard activated for CP input; 
J some data entered 

Figure 2. Attention Handling in CP Mode 



Input line cancelled; keyboard 
activated for CP input 
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VM/370 Command Structure 

A VM/370 command consists of a command name, usually followed by one or 
more positional operands and, in some cases, by an option list. The 
general form for the command line is: 

| command name | [operand...] [ (option. ..[) ]] I 



You must use one or more blanks to separate each entry in the command 
line unless otherwise indicated. 



THE COMMAND NAME 

The command name is an alphameric symbol of not more than eight 
characters. In general, the names are verbs that describe the function 
you want the system to perform. For example, you may want to find out 
whether a certain user is logged on the VM/370 system. In this case, 
you would use the CP QUERY command. 



THE COMMAND OPERANDS 

The command operands are keywords and positional operands of no more 
than eight alphameric characters each. The operands specify the 
information on which the system operates when it performs the command 
function. For the QUERY command, for example, you could use the USER or 
userid operand to find out whether the user is on the system. 

Some commands reguire no operands; others reguire several. You will 
find each class G and class Any command with all of its operand 
reguirements in "section 5. Format of CP Commands" of this publication. 

You must write the operands in the order in which they appear in the 
command formats in section 5, unless otherwise specified. 



THE COMMAND OPTIONS (CMS only) 

The command options are keywords used to control the execution of the 
command. The option list must be preceded by a left parenthesis; the 
closing parenthesis is not necessary. 



COMMENTS IN THE CP COMMAND LANGUAGE 



You can write comments with CP commands of the following types: 

• Commands with no operands 

• Commands with a fixed number of operands 

• Commands with a single optional operand 
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You should not write comments with commands that have a variable 
number of operands or with commands that have more than one optional 
operand. If you do, the comment could be interpreted as an operand. 

You can enter comments on your console by using the CP * command. 



CHARACTER SET USAGE 



VM/370 commands are entered using a combination of characters from six 
different character sets. The contents of each of the character sets is 
described in Figure 3. 



Character Set | 

Separator 

National 



Alphabetic 

Numeric 
Alphameric 



Names 



I Symbols 



Dollar Sign 
Pound Sign 
At Sign 

Upper Case 
Lower Case 

Numeric 

National 
Alphabetic 

Numeric 



Special 
Figure 3. Character Sets and Their Contents 



Blank 



* 

a 

a - z 

a - z 

0-9 

$ , # , 3 
A - Z 
a - z 
0-9 

All other 
characters 



TRUNCATING AND ABBREVIATING COMMANDS 



To make the entering of commands on the keyboard more convenient, VM/370 
allows many commands (as well as many operands and options) to be used 
in a shortened form. The shortened form can be either an abbreviation 
or a truncation to its minimum form. Minimum truncations are shown 
within the format box of each command and abbreviations are shown with 
the description that follows the format box for all the command formats 
in Section 5. 

An example of command truncation is the QUERY command. The format 
shows the command as "Query". This means you can enter the QUERY 
command in any of the following forms: 

query 

quer 

que 

q« 
q 
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Q is the minimum truncation, but CP accepts all of the above forms of 
the command. 

Abbreviations are shorter forms of commands and operands. 
Abbreviations for commands are shown below the full name of the command 
in the format box. Abbreviations for operands are shown in the 
description of the individual operands that follow the format box. 

An example of command abbreviation is the MESSAGE command. The 

format shows the command as "Message" and "MSG". This means^"tTi^t not 

only can you truncate the command to a minimum truncation of "M" but you 

can also use the abbreviation "MSG". Therefore, CP will accept all the 
following forms of the MESSAGE command: 

message 

messag 

messa 

mess 

mes 

me 

m 

msg 
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Section 3. The CP Command Language 



The CP commands represent a set of interactive console functions that 
are used (1) by the operator to control the VM/370 system and (2) by a 
user to control a virtual machine. In this publication, only those 
commands that are used to control a virtual machine are fully 
documented. Other commands are referenced only to the extent necessary 
to show relationships and provide general knowledge. 



Privilege Classes for CP Commands 

Each user of VM/370 is assigned one or more privilege classes as part of 
the directory entry of the virtual machine. Each user class is 
indicative of a specific function of a virtual machine and entitles the 
user to a specific subset of the CP command language. 

Figure 4 lists each CP privilege class along with the associated type 
of user and function performed. Figure 4 also identifies the specific 
publications in which each class subset of CP commands is described in 
detail. 

Figure 5 is a list of CP commands by privilege classes. If the 
available operands for a command vary by class, the valid operands are 
also listed. 

Although users are functionally divided into seven classes, A through 
G, with a corresponding privilege class of CP commands, there is a small 
group of commands available to all users. This eighth classification of 
CP commands is the Any class. 

This publication addresses itself as a reference manual for only the 
class G and Any subsets of the CP command language. 
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Class 



A* 



C»,2 

D* 
El, 2 

G* 
Any 1 

H 



User and Function 



£Eiiari System Operator: The class A user controls the 
VM/370 system. Class A is assigned to the user at the VM/370 
system console during IPL. The primary system operator is 
responsible for the availability of the VM/370 system and its 
communication lines and resources. In addition, the class A 
user controls system accounting, broadcast messages, virtual 
machine performance options and other command operands that 
affect the overall performance of VM/370. 

Note: The class A system operator who is automatically logged 
on during CP initialization is designated as the primary 
system operator. 

System Resource Operator: The class B user controls all the 
real resources of the VM/370 system, except those controlled 
by the primary system operator and spooling operator. 

System Programmer: The class C user updates certain 
functions of the VM/370 system. 

Spooling Operator: The class D user controls spool data 
files and specific functions of the system's unit record 
eguipment. 

System Analyst: The class E user examines and saves certain 
data in the VM/370 storage area. 

Service Representative: The class F user obtains, and 
examines, in detail, certain data about input and output 
devices connected to the VM/370 system. 

General User: The class G user controls functions associated 
with the execution of his virtual machine. 

The Any classification is given to certain CP commands that 
are available to any user. These are primarily for the 
purpose of gaining and relinguishing access to the VM/370 
system. 

Reserved for IBM use. 



1 Described in the VM/370: Operator's Guide. 

2 Described in the VM/370: System Programmer's Guide and the 

Hi/370: System Logic and Problem Determination Guide. 
3 Described in the VM/370: QLTSEP and Error Recordincj Guide. 
♦Described in this publication. 



Figure 4. CP Privilege Class Descriptions 
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| Class 


Commands 
* 


I Operands 


| | Class 


Commands 


Operands | 


1 Any 






POLLDLAY | 




#CP 








QUERY | 




CP 








VARY | 




DIAL 






QUERY 


ALL | 




DISCONN 








DASD | 




LOGOFF 








DUMP | 




LOGON 








GRAF | 




MESSAGE 








LINES | 




SLEEP 








LOGMSG | 
NAMES | 


1 A 


ACNT 

AUTOLOG 

DISABLE 

ENABLE 

FORCE 

HALT 

LOCK 








raddr | 
SPOOL | 
STORAGE | 
SYSTEM | 
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| Class | Commands 


I Operands | | Class | Commands 


Operands | 
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THE G CLASS COMMANDS 



The general user uses the class G commands to control the virtual 
machine, much as an operator controls a real machine. The user can stop 
execution in the virtual machine; restart execution; simulate external, 
attention, and device ready interruptions; inspect and modify virtual 
storage, registers and PSW; initiate tracing facilities; and invoke the 
spooling and disk sharing functions of CP. 
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THE ANY CLASS OF COMMANDS 

The Any privilege class contains those commands that are available, with 
the same format and operands, to all user classes. Some of these 
commands are used to gain initial access to the VM/370 system. The 
LOGON command identifies you to the system and sets up your virtual 
machine. The DIAL command allows you to establish a logical connection 
between your terminal and a previously logged-on multiple-access virtual 
machine. If you cannot log on for some reason, such as a faulty line 
connection or someone else using your user identification, the MESSAGE 
command allows you to communicate with the system operator or some other 
user. 
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Part 2. Reference Information 



Part 2 contains reference information. It consists of two sections. 

"Section 4. Notational Conventions" describes the syntax that is used 
in this publication to display command formats. 

"Section 5. Format of CP Commands" contains reference data for all 
the class G and Any commands in alphabetical sequence by command name. 
The command line format includes all operands and a description of 
each. Any limits or restrictions applicable to the values of variable 
operands are also defined. 
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Section 4. Notationcri Conventions 



The notation used to define the command syntax for VM/370 is: 

• Truncations and Abbreviations of Commands 

Where truncation of a command name is permitted, the shortest 
acceptable version of the command is represented by uppercase 
letters. (Remember, however, that VM/370 commands can be entered 
with any combination of uppercase and lowercase letters.) The 
example below shows the format specification for the INDICATE 
command. 

INDicate 

This representation means that IND, INDI, INDIC, INDICA, INDICAT, and 
INDICATE are all valid specifications for this command name. 

Operands are specified in the same manner. Where truncation is 
permitted, the shortest acceptable version of the operand is 
represented by uppercase letters in the command format box. If no 
minimum truncation is noted, the entire word (represented by all 
capital letters) must be entered. 

Abbreviations are shorter forms of command names and operands. 
Abbreviations for command names are shown below the full name in the 
format box. Abbreviations for operands are shown in the description 
of the individual operands that follows the format box. For example, 
the operand READER has both a minimum truncation and an 
abbreviation. In the format box, it is shown as: 

Reader 

indicating that the minimum truncation is R. In the discussion of 
the READER operand that follows the format block, it is shown as: 

READER 
RDR 

indicating that the abbreviation is RDR. Thus, the acceptable 
specifications for the READER operand are: R, RE, REA, READ, READE, 
READER, and RDR. 

In some cases what appears to be a minimum truncation is really the 
only valid abbreviation. For example, the abbreviation for MEMBER is 
MEM. Only these two forms are valid and no truncations are allowed. 
The format box contains 

MEMBER 



/name ) 
and the description that follows the format box is 



MEMBER 
MEM 



{T e } 
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• The following symbols are used to define the command format and 
should never be typed when the actual command is entered. 

underscore _ 
braces { } 
brackets [ ] 
ellipsis 

• Uppercase letters and words, and the following symbols, should be 
entered as specified in the format box. 

asterisk * 

comma , 

hyphen 

egual sign = 

parentheses ( ) 

period 

colon : 

• Lowercase letters,, words, and symbols that appear in the command 
format box represent variables for which specific information should 
be substituted. For example, "hexloc" indicates that a hexadecimal 
storage location address is to be entered. 

• Choices are represented in the command format boxes by stacking. 

A 
B 
C 

• An underscore indicates an assumed default. If an underscored choice 
is selected, it need not be specified when the command is entered. 

Examp_le 

The representation 

A 

B 

C 

indicates that either A, B, or C may be selected. However, if B is 
selected, it need not be specified. Or, if none is entered, B is 
assumed. 

• The use of braces denotes choices, one of which must be selected. 

Example 

The representation 

r i 

I A I 

< B > 

I C | 

L J 

indicates that you must specify either A, or B, or C. If a list of 
choices is enclosed by neither brackets or braces, it is to be 
treated as if enclosed by braces. 
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• The use of brackets denotes choices, one of which may be selected. 

Example 

The representation 

r i 

I A | 

I B | 

I C | 

L J 

indicates that you may enter A, B, or C, or you may omit the field. 

• An ellipsis indicates that the preceding item or group of items may 
be repeated more than once in succession. 

Example 

The representation 

{spoolidl spoolid2...} 

indicates that more than one spoolid may be coded within the braces. 
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Section 5. Format of CP Commands 



The command formats are described in alphabetical order except for 
special characters such as the asterisk (*) and the pound sign (#) , 
which appear first. 
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* 

£EiXi3:§3§ Class: Any 

Use * to annotate the terminal console sheet or terminal display screen 
data with a comment. This commentary also appears in the virtual 
console spool file (if the console spooling function is invoked for the 
virtual machine) . The format of the * (comment) command is;: 



i 

I * | anycomment 
i 



Responses 



None. 
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#CP 

#CP 

££1X12 ®c[e Class: Any 

Use the #CP command to execute a CP command while in a virtual machine 
command environment without first signaling attention to get to the CP 
command environment. The format of the #CP command is: 



"i 



| #CP | [ commandlinel [ #commandline2 #...]] I 



where : 

commandline specifies the name and operands for the CP command or 
commands you want to issue. You must precede the first 
commandline with at least one blank. 

U§sLSJ=: S2tes 

1. The pound sign (#) shown in the preceding format represents the 
logical line end symbol currently in effect for your virtual 
machine. If you have redefined the logical line end symbol, #CP is 
an invalid command; you must substitute your line end symbol for 
the pound sign when using this command. 

2. For the command to operate, the following conditions must be met: 

• The virtual machine must be operating with SET LINEDIT ON (a 
default) . 

• The first three characters of the edited line must be #CP 
(uppercase or lowercase) with the "#" representing the logical 
line end symbol currently defined. 

• At least one blank must separate the #CP from any command line. 
Do not use attention interruption in any part of the line or to 
enter the line. 

• If in a virtual machine command environment, the virtual machine 
must have issued a READ for at least four bytes of data. If the 
READ is for less than four bytes you must use the Attention key 
to enter the CP environment. 

3. You can enter multiple command lines as operands of the #CP command 
provided that (a) the virtual machine's console READ is for at 
least the number of bytes required to enter the entire line and (b) 
all command lines to be executed must be separated by the current 
logical line end symbol. 

H. If you enter #CP with no operands, the virtual machine enters the 
CP environment. CP cancels the virtual machine's console READ by 
returning a unit exception status for the virtual console. The 
virtual operating system then reissues the console READ to allow 
you to key in the appropriate response to a previous message from 
that machine's operating system. 
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#CP 



Command 



#CI? 



#CP query files 

#CP query files#query users 



data entered2#CP msg op is tape 
available 



#CP data entered 



data enteredg#CP 



#C1? query files0data entered 



System Action 

Your virtual machine enters 
CP environment. 

QUERY command executed. 

Two separate QUERY commands 
executed. 

"Data entered" is ignored. You 
send a message to the 
operator. 

You enter CP environment and 
CP interprets "data entered" 
as an invalid operand. 

"Data entered" is ignored. You 
enter CP environment. 

QUERY command is not executed; 
console input (data entered) 
passes to the virtual machine, 



1§ spouse s : 

If you enter #CP without a commandline, you receive this message: 
CP 

If you enter #CP with commandlines, you receive the responses 
appropriate to the individual commands you entered. 
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ADSTOP 



ADSTOP 

Privilege Class: G 



Use the ADSTOP command to halt the execution of a virtual machine at a 
virtual instruction address. Execution halts when the instruction at 
the address specified in the command is the next instruction to be 
executed. The format of the ADSTOP command is: 



| ADSTOP | / hexloc ) 

I I 1 OFF j 



where: 

hexloc is the hexadecimal representation of the virtual instruction 
address where execution is to be halted. Since ADSTOP 
modifies storage, an address specified within a shared segment 
results in the virtual machine being placed in nonshared mode 
with its own copy of the shared segment. A fresh copy of the 
shared segment is then loaded for the use of the other users. 

OFF cancels any previous ADSTOP setting. 



1. When execution halts, the CP command mode is entered and a message 
is displayed. At this point, you may invoke other CP debugging 
commands. To resume operation of the virtual machine, issue the 
BEGIN command. Once an ADSTOP location is set, it may be removed 
by one of the following: 

• Reaching the virtual storage location specified in the ADSTOP 
command 

• Performing a virtual IPL or SYSTEM RESET 

• Issuing the ADSTOP OFF command 

• Specifying a different location with a new ADSTOP hexloc command 

2. Since the ADSTOP function modifies storage by placing a CP SVC 
X*B3 I at the specified location, you should not: 

• Examine the two bytes at the instruction address because CP does 
not verify that the location specified contains a valid CPU 
instruction. 

• Use the TRACE command with the INSTRUCT, BRANCH, or ALL operands 
if any traced instruction is located at the ADSTOP address. 

3. Address stops may not be set in an OS/VS or DOS/VS virtual 
machined virtual storage; address stops may be set only in the 
virtual=real partitions or regions of those virtual machines. 
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ADSTOP 

t\. If the SVC handling portion of the virtual machine assist feature 
is enabled on your virtual machine, CP turns it off when an ADSTOP 
is set. When the address stop is removed, CP returns the assist 
feature SVC handling to its previous status. 



Response 

ADSTOP AT xxxxxx 

The instruction whose address is xxxxxx is the next instruction 
scheduled for execution. The virtual machine is in a stopped 
state. Any CP command (including an ADSTOP command to set the next 
address stop) can be issued. Enter the CP command BEGIN to resume 
execution at the instruction location xxxxxx, or at any other 
location desired. 
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ATTN 

ATTN 

Privilege Class: G 

Use the ATTN command to make an attention interruption pending at your 
virtual console. The format of the ATTN command is: 



j ATTN 



P-Sa^e Notes 

1. The REQUEST command performs the same function as ATTN; the two 
commands can be used interchangeably. 

2. The BEGIN command is not required after you issue ATTN. 



Responses 



None. 
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BEGIN 

BEGIN 

HEixllege Class: G 

Use the BEGIN command to continue or resume execution in the virtual 
machine at either a specified storage location or the location pointed 
to by the virtual machined current program status word (PSW). The 
format of the BEGIN command is: 



| Begin | [hexloc] I 



m her e : 

hexloc is the hexadecimal storage location where execution is to 
begin. 



Usage Notes 

1. When BEGIN is issued without hexloc, execution begins at the 
storage address pointed to by the current virtual machine PSW. 
Unless the PSW has been altered since the CP command mode was 
entered, the location stored in the PSH is the location where the 
virtual machine stopped. 

2. When BEGIN is issued with a storage location specified, execution 
begins at the specified storage location. The specified address 
replaces the instruction address in the PSW, then the PSW is 
loaded. 



Jtesppnses 

None. The virtual machine begins execution, 
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CHANGE 

CHANGE 

E£i li!§2§ Class : G 

Use the CHANGE command to alter one or more of the external attributes 
of a closed spool file or files. The format of the CHANGE command is: 



CHange 



Reader ( CLass cl) I CLass c2 NAME 
Printer / spoolid > \copy nn 
PUnch J ALL ) ] r i 

|HOld | 

|NOHold| 

L J 

DIst distcode 



/fm [ft]) 
\ dsname J 



1 0ne of these operands must be chosen; however, more than one may be 
specified. They may be combined in any order, except for NAME, which 
if specified, must be the last entry in the command line. This is 
contrary to the notation normally used in this publication. 



wh er e : 

READER changes the reader spool file. 
RDR 

PRINTER changes the printer spool file. 
PRT 

PUNCH changes the punch spool file. 
PCH 

CLASS c1 designates an existing class. The class, c1, is a 
one-character alphameric field from A to Z or from 0-9. Refer 
to the VM/370: O^erator^s Guide for a detailed description of 
spool classes. 

spoolid is the spoolid number of the file that is to be changed. 

ALL changes all your spool files. 

CLASS c2 changes the spool class of the file to c2. 

COPY nn specifies the number of copies of the file to be spooled to 
the virtual output device. This option is valid for printer 
and punch files only. The value of nn (number of copies) must 
be a number from 1 through 99. For nn less than 10, the 
leading zero is optional. 

HOLD prevents the file from being printed, punched, or read until 
it is released. The file is released when the CHANGE command 
is issued with the NOHOLD operand specified. 

NOHOLD releases the specified file from user HOLD status. 

DIST distcode 

changes the distribution code specified in the VM/370 
directory to the distcode specified on the command line, for 
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CHANGE 

the specified file only. The distribution code appears on the 
output separators of the printer and punch output; it has no 
effect on reader files. 

NAME fn [ft] 

assigns identification to the spool file in the CMS format 
filename and filetype. The field, fn, is a one- to 
eight-character alphameric filename assigned to the file for 
identification. The field, ft, is a one- to eight-character 
alphameric filetype assigned to the file for identification. 
If ft is not specified, the filetype is set to blanks. 

NAME dsname 

assigns identification to the spool file in a non-CMS format. 
The field, dsname, is a 1- to 24-character field suitable for 
specifying OS or DOS files (for example, SYS1. SYSLIB.MYMAC) . 



linage Notes 

1. Issue the QUERY command to determine the current attributes of the 
file. 

2. In order to change an output file, the file must have been closed 
but not yet selected for printing or punching. 

3. An input (READER) file can be changed at any time before it is 
opened, that is, before the first read is issued for the file. 

4. Use the QUERY command to verify the new attributes of the file or 
files. 

5. If the spoolid operand is used and if more than one spool file with 
that number exists, then only the first spool file encountered will 
be changed. 



Response 

I'nnnn) FILES CHANGED 



j nnnnj 
I NO } 



This is the response when you issue the CHANGE command. This is an 
indication of the number of files changed. It does not reflect 
individual alterations to a given file. This message does not 
appear if you have issued the CP SET IMSG OFF command line. 
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CLOSE 



CLOSE 



££ivii§2§ Cl ass : G 



Use the CLOSE command to terminate the spooling activity on any virtual 
spooled unit record or console device. The format of the CLOSE command 
is: 




I Reader r t 

Ivaddr | HOld | 

| |NOHold| 

L L J 



ICONsole 
I Printer 
IPUnch 
Ivaddr 



PUrge 



| HOld | [DIst distcode] |NAme 
|NOHold| | 

L J L 



ffn [ft])| 
\dsname jj 



where : 

READER 
RDR 



closes all reader spool files. 



CONSOLE 



PRINTER 
PRT 



closes your virtual machine's console spool file. Once a 
virtual console spool file is closed, it becomes a printer 
spool file and can be manipulated in the same way as any 
printer spool file (for example, it can be purged or 
changed) . 

closes all printer spool files. 



PUNCH 
PCH 



closes all punch spool files. 



vaddr 



HOLD 



is the virtual address (cuu) of the device to be closed. The 
address may represent a reader, console, printer, or punch. 

makes the spool file being closed unavailable for further 
processing, until it is specifically reguested or changed. 
This option, specified in the CLOSE command, overrides any 
previously specified HOLD or NOHOLD option for the files being 
closed. 



NOHOLD makes the spool file being closed available for further 

processing. Specify NOHOLD if a HOLD established by the SPOOL 

command is still in effect and the current active file is not 
to be held. 

You can release one of your own output files in HOLD status by 
using the CHANGE command. If an output file is spooled for 
another user (SPOOL FOR userid) , only the receiving virtual 
machine user can change the file status. If an output file is 
spooled to a user as an input file (SPOOL TO userid) , the HOLD 
option places the input file in HOLD status. The file then 
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CLOSE 

cannot be read by the virtual machine until it is changed to 
NOHOLD by the receiving virtual machine user. 

If an input file is closed with the HOLD option, the file is 
saved and not purged from the system. The saved file is 
available for virtual machine and user processing and is not 
placed in a user hold status. Input spool files that are 
closed are normally purged from the virtual machine. 

PURGE closes and immediately purges from the virtual machine the 
output spool files. No output file is produced. 

DIST distcode 

uses the 1- to 8-character alphameric identification 
(distcode) on the output separators of printer and punch 
instead of the identification specified in the VM/370 
directory. The distribution code is changed for this file 
only and does not affect other files or change the VM/370 
directory. If the file is transferred to another user, this 
option has no effect. 

NAME fn [ ft] 

assigns identification to the spool file in the CMS format 
filename and filetype. fn is a 1- to 8-character alphameric 
filename assigned to the file for identification, ft is a 1- 
to 8-character alphameric filetype assigned to the file for 
identification. If ft is not specified, the filetype is set 
to blanks. 

NAME dsname 

assigns identification to the spool file in a non-CMS format. 
The dsname field is a 1- to 24-character field suitable for 
specifying OS or DOS files (for example, SYS1. SYSLIB.MYMfiC) . 
Only 20 characters of the 24-character dsname are displayed by 
QUERY, even though a name of up to 24 characters is valid. 



1. If the file is an input reader file, the file being processed is 
purged unless SPOOL READER HOLD was previously specified (see the 
SPOOL command) . The effect of HOLD or NOHOLD for a particular file 
established by the SPOOL command can be overridden by specifying 
NOHOLD or HOLD, respectively, in the CLOSE command. 

2. If the file is an output file on a printer, punch, or console, the 
file is either gueued for output on a real unit record device, or, 
if the virtual output device is transferred (by use of the "SPOOL 
vaddr TO userid" command) , the file is gueued for input to the 
receiving user. 

3. You can specify a filename and filetype and an optional 
distribution code to aid in later identification of the file and 
its contents. 

4. Figure 6 depicts the status of the file in your virtual device, 
depending on the previously stipulated SPOOL command options in 
effect when the CLOSE command is invoked. The CLOSE command can 
result in a file being held, saved, or purged. 
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CLOSE 



Virtual 

Device 

Status 



(CLOSE 
Command 
Setting) 

Normal EOF 
(default 
CLOSE) 



CLOSE 

CLOSE HOLD 
CLOSE NOHOLD 



SPOOL Command Options Set for a Virtual Device 



NOHOLD 
NOCONT 



HOLD 
NOCONT 



NOHOLD 
CONT 



HOLD 
CONT 



File released |File saved |File released|File held 
for proces- | |for proces- | 

sing | | sing | 



File released |File saved |File released | File held 
for proces— | | f or proces— | 

sing | | sing | 



File saved |File saved |File held 



| File held 



File released |File released | File released | File released 
for proces- | f or proces- | f or proces- |for proces- 
sing |sing |sing jsing 



Note: The term "saved" means that the file is neither purged nor is it 
in HOLD status. A subseguent READ could read this file. 

Figure 6. Spool Command Options Set for a Virtual Device. 



Responses 



PRT) 

PUN \ FILE spoolid 

CONJ 



{TO 1 
\ FOR/ u 



serid COPY 



( HOLD ) 
nn (NOHOLD) 



This response is received if: multiple copies of the file are being 
processed, the file is being transferred to another user, or the 
file is placed in a USER HOLD status. However, if the SET MSG 
option is OFF, this message is not issued even though the preceding 
conditions are met. 
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COUPLE 

COUPLE 

P.EiXii§3e Class: G 

Use the COUPLE command to connect your virtual (non-dedicated) 
channel-to-channel adapter (CTCA) to another user's virtual 
channel-to-channel adapter (or to another one of your own virtual 
channel-to-channel adapters) . The format of the COUPLE command is: 



I COUPLE | vaddrl [To] userid vaddr2 | 



where : 

vaddrl is the virtual address (cuu) of your channel-to-channel 
adapter. 

[TO] userid 

is the user identification of the virtual machine to which 
vaddrl is to be connected. If vaddrl is to be connected to 
your own virtual machine, userid may be specified as an 
asterisk (*) . The user must be logged on and have a virtual 
channel-to-channel adapter defined. If the keyword TO is 
omitted, the userid cannot be "T" or "TO". 

vaddr2 is the virtual address (cuu) of the channel-to-channel adapter 
to be connected to vaddrl. 



Responses 

CTCA vaddrl COUPLE TO userid vaddr2 

This is the response you receive when you issue the COUPLE 
command. 

vaddrl is the address of your channel-to-channel adapter. 

userid is the identification of the receiving virtual machine. 

vaddr2 is the address of the channel-to-channel adapter of the 
receiving user (or a different channel-to-channel adapter 
in your own virtual machine) . 

CTCA vaddr2 COUPLE BY userid vaddrl 

This is the response that the user specified by userid receives 
when you issue the COUPLE command. 

vaddr2 is the address of the channel-to-channel adapter of the 
receiving user. 

userid is the identification of the user who issued the COUPLE 
command. 
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vaddrl is the address of the issuing user's channel-to-channel 
adapter. 

CTCA vaddrl DROP FROM userid vaddr 

This is the response that the user who issued the COUPLE command 
receives if the virtual CTCA vaddrl was already coupled when the 
COUPLE command was issued. The previous connection is terminated. 
This response is always followed by the response: 

CTCA vaddrl COUPLE TO userid vaddr2 
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CP 

P^iliiea® Class: Any 

Use the CP command if you are a CMS user and want to execute a CP 
command when a CMS read has been issued to the console, without first 
signaling attention to get to the CP environment. This statement 
operates similarly when the console is in the CP environment. The 
format of the CP command is: 



CP | [ commandline 1 [ #commandline2 #...]] I 



where : 

commandline specifies the name and operands for the CP command or 
commands you want to issue. You must precede the first 
commandline with at least one blank. 



Usage Notes 

1. The pound sign (#) shown in the format block represents the logical 
line end symbol currently in effect for your virtual machine. If 
you have redefined the logical line end symbol, you must substitute 
your line end symbol for the pound sign when using this command. 

2. The CP command is treated as a null line by the control program and 
therefore can precede any other command if one or more blanks 
separate CP from the other command. The CP command is useful 
because it lets the CMS user enter commands without having to know 
which command environment (CP or virtual machine) he is in. 

3. You can enter multiple command lines as operands of the CP command, 
but you must separate each command line by the logical line end (#) 
symbol. If you enter only CP with no operands, the virtual machine 
enters the CP environment. CP cancels the virtual machine's 
console READ by returning a unit exception status for the virtual 
console. The virtual operating system then reissues the console 
READ to allow you to key in the appropriate response to a previous 
message from that machine's operating system. 



H§sppnses 

If you enter CP without a commandline, you receive this message: 

CP 

If you enter CP with commandlines, you receive the responses appropriate 
to the individual commands you entered. 
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DEFINE 



Efivilege Class: G 



Use the DEFINE command to alter your virtual machine configuration or 
channel operating mode. The format of the DEFINE command is: 



DEFine 



Reader 

Printer 

PUnch 

CONsole 

CTCa 

TIMer 

1403 

1443 

2501 

2540P 

2540R 

3211 

3505 

3525 

CHANnels [As 



[As] vaddr 



] /SEL1 
(. BMX J 



Line 



GRAF 



[As] vaddr |IBML!J | 
|TELE[2]| 

L J 



cuu [32701 
L 3158 J 

vaddr 1 [As] vaddr2 



T2305 
T2314 
T2319 
T3330 
T3340 
T3350 

STORage 



[As] vaddr [CYL] nnn 



[As ] f nnnnnK ) 
InnM J 



w h er e : 

READER [AS] vaddr 
RDR 



PRINTER [AS] vaddr 
PRT 



PUNCH [AS] vaddr 
PCH 



CONSOLE [AS] vaddr 



adds a spooling 2540 card reader with the address 
specified by vaddr to the virtual machine 
configuration . 

adds a spooling 1403 printer with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 2540 card punch with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a virtual system console to the virtual 
machine at the address specified by vaddr. 
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CTCA [AS] vaddr 



TIMER [AS] vaddr 
14 03 [AS] vaddr 
1443 [AS] vaddr 
2501 [AS] vaddr 
2540P [AS] vaddr 
2540B [AS] vaddr 
3211 [AS] vaddr 

3505 [AS] vaddr 
3525 [AS ] vaddr 



CHANNELS [AS] 



( SEL ) 
( BMX J 



adds a virtual channel-to-channel adapter with the 
address specified by vaddr to the virtual machine 
configuration. The control unit address must end 
in zero, and must not already be in use. Once the 
control unit is defined, other virtual devices may 
not be defined for the same CTCA. 

adds a pseudo timing device with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 1403 printer with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 1443 printer with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 2501 card reader with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 2540 card punch with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 2540 card reader with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 3211 printer with the address 
specified by vaddr to the virtual machine 
configuration. The virtual 3211 printer supports 
LOADVFCB and the Index feature. 

adds a spooling 3505 card reader with the address 
specified by vaddr to the virtual machine 
configuration. 

adds a spooling 3525 card punch with the address 
specified by vaddr to the virtual machine 
configuration. 

redefines the channel mode of operation 
for the virtual machine to either selector or block 
multiplexer. Use of the SEL (selector channel) or 
BMX (block multiplexer channel) operand sets the 
mode of operation for all channels except virtual 
channel 0. Channel always operates in byte 
multiplexer mode. The real or virtual 
channel-to-channel adapter always operates in 
selector mode. 

Block multiplexer mode may enhance the virtual 
machine's operating system by allowing the overlap 
of Start I/O operations. This is done by 
reflecting a channel condition code of back to 
the virtual machine rather than a channel busy 
signal. 

Note: The virtual machine is immediately reset when 
this set of operands is executed. 
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:uu [3270 1 
L 3158 J 



DEFINE 



r n 

LINE [AS] vaddr |IBMJ | 
|TELE2| 

L J 

adds a virtual 2701/2702/2703 communication line 
with the address specified by vaddr to the virtual 
machine configuration. 

IBM1 indicates that an IBM-type terminal (2741, 
1050, or equivalent) is on the 2701/2702/2703 line. 
TELE2 indicates that a teletypewriter is on the 
2701/2702/2703 line. 

GRAF cuu f 3270 "I defines a temporary 3270 or 3158 (the 

system console used on the IBM System/370 Model 
158) for the virtual machine. The cuu is the 
hexadecimal virtual address for the device. After 
you define the 3270 or 3158, you must issue the CP 
DIAL command from the device in order to use it. 
The device must be supported by the virtual 
machined operating system. 

vaddrl [AS] vaddr2 redefines the device represented by vaddr 1 as 

vaddr2. The virtual address, vaddrl, must 

represent a defined device in the virtual machine 
configuration. 

If vaddrl is a dedicated 2703, both vaddrl and 
vaddr2 must be specified as base addresses (xxO or 
xx8) . Also, when you redefine a dedicated 2305, 
all 8 exposure addresses are redefined. For 
example, if 1 bO is the virtual address of a 
dedicated 2705, the command 

define 1d0 as 1b0 

redefines addresses 1d0 through 1d7 as 1b0 through 
1b7, respectively. 

T2305 [AS] vaddr [CYL] nnn 

T2314 adds a temporary virtual disk of the specified 

T2319 type to the virtual machine configuration. 

T3330 The vaddr specifies the address of the disk, 

T3340 and must not be on a virtual control unit 

T3350 already defined as a CTCA. CYL nnn specifies the 

number of cylinders that the disk contains. 

Specify T3350 if a 3350 is used in native mode; 

specify T3330 if a 3350 is used in 3330 

compatibility mode. 

Note: Temporary disk space is assigned from a pool 
of DASD resources. You should always format your 
temporary disk space before you use it. For the 
same reason, you should always clear temporary disk 
space before you either release it or log off. 
Uncleared data on your detached T-disk could be 
accessed by another user assigned that same area in 
a subsequent DEFINE operation. 



STORAGE [AS] 



( nnnnnK\ 
\nnM J 



redefines the size of the virtual storage for the 
virtual machine as nnnnnK (where K represents 1024 
bytes) or nnM (where M represents 1,048,576 bytes). 
The value specified becomes the new virtual storage 
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size. sizes must be in 4K increments and are 
limited by the maximum value in the VM/370 
directory entry. The minimum size you can specify 
is 8K. All entries not specified in a 4K increment 
are rounded up to the next 4K boundary. Changing 
the virtual storage size (increasing or decreasing) 
causes a virtual system reset and clears all 
virtual storage to binary zeros. 



Usage Notes 

1. When you alter the configuration or channel operating mode of your 
virtual machine via the DEFINE command, the changes are temporary 
and are in effect for the current terminal session only. 

2. If either storage or channel operating mode is altered, the virtual 
machine is immediately reset and the IFL procedure must be 
performed again. 

3. If storage is redefined, any pages that have been locked via the 
LOCK command become unlocked. 

U. If your virtual machine is operating in the Basic Control Mode 

(ECMODE OFF), virtual addresses specified in vaddr, vaddr 1, and 

vaddr2 can be no higher than 5FF (channels 0-5) . If operating in 

Extended Control Mode (ECMODE ON) , all addresses through FFF are 

valid. 



Responses 

Responses are generated to confirm that the desired configuration change 
has taken place. These responses do not appear on your terminal if you 
have issued the CP SET IMSG OFF command line. 

type vaddr DEFINED 

where the possible values for type have the following meanings: 



Type 


Meaning 


DASD 


Direct access storage device 


TAPE 


Magnetic tape 


LINE 


Communication line 


RDR 


Card reader 


PRT 


Line printer 


PUN 


Card punch 


GRAF 


Graphics device 


CONS 


Console 


CTCA 


Channel-to-channel adapter 


CHANNELS = 


( SEL) 



is the channel mode of operation for the virtual machine. This 

response applies to all channels except channel (always a byte 

multiplexer channel) and any channel that has a virtual or real 
channel-to-channel adapter (always a selector channel) . 
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STORAGE = nnnnnK 

verifies the new storage size of your virtual machine. The minimum 
storage you may specify is 8K. 
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DETACH 

Privilege Class: G 

Use the DETACH command to remove a virtual device from the virtual 
machine. The format of the DETACH command is: 



| vaddr 



wh ere : 

vaddr is the virtual address (cuu) of the device to be detached from 
your virtual machine. If the device being detached is a 
dedicated 2305, the virtual address you specify must be a base 
address (xxO or xx8) . 



Usage Notes 

1. You can detach a previously attached device even if the device is 
currently in use. You can also detach devices that were attached 
because of VM/370 directory entries or during CP system 
initialization. 

2. When you detach a virtual device, it becomes inaccessible to your 
virtual machine. If the device was previously attached to your 
virtual machine by an ATTACH command, it is released and becomes 
available for attachment to your virtual machine, another user, or 
the CP system. Tape devices are automatically rewound and unloaded 
when detached. 

3. If you detach a device that was previously attached to your virtual 
machine by the operator, a message is sent to the operator 
informing him that the device is free. 



Responses 

Messages are sent to you, the operator who issued the command, and the 
primary system operator (if different from the operator who issued the 
command) , to indicate that the DETACH was successful. 

type vaddr DETACHED 

This is the response you receive when you detach one of your own 
devices. You do not receive this response if you have issued the 
CP SET IMSG OFF command. 

type vaddr DETACHED BY operator 

This is the response you receive if an operator detaches one of 
your devices. 
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r t 

type raddr DETACHED |userid| 

ISYSTEM | 

L J 

This is the response sent to the operator if you detach a 
previously attached device, or if the operator detaches it from a 



user or the system. 



type raddr DETACHED | userid | BY operator 

|SYSTEM| 

L J 

This is the response sent to the primary system operator if he did 
not issue the DETACH command and the device had been previously 
attached. 

CTCA vaddr DROP FROM userid vaddr 

This is the response if the device detached was a virtual CTCA connected 

(via the COUPLE command) to another CTCA on the virtual machine 

specified by the userid. This response is always followed by the 
response : 

CTCA vaddr DETACHED 

unless the SET IMSG OFF command was issued. 

In the above responses, type is one of the following: 

Type Meaning 

DASD Direct access storage device 

TAPE Magnetic tape 

LINE Communication line 

RDR Card reader 

PRT Line printer 

PUN Card punch 

GRAF Graphics device 

CONS Console 

CTCA Channel-to-channel adapter 

DEV Any other device 
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DETACH CHANNEL 

E£i2il§a§ Class: G 

Use the DETACH CHANNEL command to detach a dedicated channel from your 
virtual machine when that channel path is no longer required for virtual 
machine I/O operations. The format of the DETACH CHANNEL command is: 



-\ 



| DETach | CHANnel c | 



where : 

CHANNEL c is the real address of the channel that is to be detached. 



JJsacje Notes 

1. If DETACH CHANNEL is invoked prior to the normal completion of I/O 
activities on the dedicated channel, those activities are aborted. 



Response 

CHANNEL C DETACHED userid 

is sent to the user who issued the command and to the primary 
system operator. 
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DIAL 

Privilege Class: Any 

Use the DIAL command to logically connect a switched line, leased line, 
or locally attached terminal to a previously logged-on multiple-access 
virtual machine. The format of the DIAL command is: 



I DIAL | userid [vaddr] I 



w h er e : 

userid is the identification of a virtual machine that is 
currently logged on. 

vaddr is the address of the virtual communication line to which 

the connection is to be made. 



U§!3§ Notes 

1. A DIAL command is accepted only at logon, and only as a substitute 
for a LOGON command. The type of terminal used must be supported 
by both VM/370 and the multiple-access virtual machine. See the 
I1L£370: Terminal UserJ.s Guide for details on running and gaining 
access to multiple-access machines. 

2. If the DIAL command is issued from a real 3277 terminal, the 
virtual system must use the CP command RESET to drop the dialed 
connection. 

3. The DIAL command is not supported for the 3066 system console or 
for terminals that are using NCP lines in a 3704/3705 control 
unit. 

4. Once the connection is made, your terminal operates entirely under 
the control of that virtual machine. The DIAL command matches your 
terminal to an eguivalent type defined in the multiple-access 
virtual machine. If no matching terminal type exists, the 
connection cannot be made and an error message is issued. 

5. The DIAL command is not supported for remote 3270 terminals. 



Responses 

DIALED TO userid vaddr 

is the message sent to the user indicating that a logical 
connection has been made. 
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(GRAF radar) 

< LINE raddr \ DIALED TO userid DIALED = nnn 
DEV resid 






is the response to the primary system operator. It indicates a 
successful connection to the virtual machine (userid) and the 
total number of VM/370 lines (nnn) currently connected to other 
virtual machines. DEV resid indicates the resource 
identification of a 3704/3705 line. 

Note: The terminal remains connected to and under the control of 
the virtual machine until that virtual machine terminates the 
communication. 

DROP FROM userid vaddr 

is the message sent to the user when the line is disabled. 

fGRAF raddr) 

/LINE raddr > DROP FROM userid DIALED = nnn 

( DEV resid) 

is the message sent to the primary system operator when the line 
is disabled. 
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DISCONN 

Privilege Class: Any 

Use the DISCONN command to disconnect your terminal from the VM/370 
system while the virtual machine continues operation. The format of the 
DISCONN command is: 



| DISConn | [HOld] I 

.j 



where : 

HOLD specifies that the communication line is not to be disabled. 
This option allows you to disconnect your terminal, and, at 
the same time, to avoid the process of telephone dialing into 
the system to access your virtual machine again. If specified, 
control returns to CP and the "VM/370 online" message is 
displayed. 



Usage Notes 

1. The terminal remains disconnected until it is reconnected via a 
LOGON command. The virtual machine is logged off 15 minutes after 
an attempt is made to read from the terminal or if the virtual 
machine goes into a disabled WAIT state. 

2. If your terminal connection is broken because of terminal, line, or 
TP control unit errors, CP places the virtual machine in disconnect 
mode for up to 15 minutes and your virtual machine does not 
continue to run. If you log on within 15 minutes, your virtual 
machine can continue operating. If you do not log on within the 
15-minute interval, the virtual machine is logged off. 

3. Unless the CP command, SPOOL CONSOLE START, is issued to spool the 
virtual console output, all "writes" or output messages to the 
virtual console are ignored. When the terminal is reconnected via 
the normal logon procedure, the terminal is placed in CP console 
function mode. To resume execution of the virtual machine, enter 
the BEGIN command. 



Responses 

When the DISCONN command is issued, the disconnect time message is 
issued. 

DISCONNECT AT hh:mm:ss zone weekday mm/dd/yy 

is the response to the user who issued the command. 
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(GSAF raddr) 

< LINE raddr > DISCONNECT userid USERS = nnn 

( DEV resid) 

is the response to the primary system operator informing him 
that the user represented by "userid" has been disconnected from 
the VM/370 system. The "nnn" is the total number of users 
remaining in the system. DEV resid indicates the resource 
identification of a 3704/3705 line. 
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DISPLAY 



PElXileae Class: G 



Use the DISPLAY command to display the following virtual machine 
components at your terminal: 

• Virtual storage locations (1st level virtual storage only; see Usage 
Notes.) 

• Storage keys 

• General registers 

• Floating-point registers 

• Control registers 

• Program status word (PSW) 

• Channel address word (CAW) 

• Channel status word (CSW) 



DISPLAY command to display the content of 
The format of the DISPLAY command is: 



Note: Use the NETWORK 
3704/3705 storage. 



Display 



r t r r t -\ 

I hexlodl |J-||hexloc2 | 

|Khexloc1| l\:/|END | 

|Lhexlcc1| | l J 

|Thexloc1| | r n 

I | |{. }|bytecount| 

L J I I END | 

L L J J 



r 
Gregl | 
Yregl | 
Xregl | 


f-0|reg2l 
I :/II»D | 

L J 


1 


L 


r i 

{ . } Iregcount | 

|END | 

L J 


J 


Psw 






CAW 






CSW 







I 



where : 

hexlod 

Lhexlod 

Thexlod 

Khexlod 





is the first, or only, hexadecimal storage location 
that is to be displayed at the terminal. If 
L or no letter prefix is specified, the storage 
contents are displayed in hexadecimal. If T is 
specified, the storage contents are displayed in 
hexadecimal, with EBCDIC translation. If K is 
specified, the storage keys are displayed in 
hexadecimal. 

If hexlod is not on a fullword boundary, it is rounded 
down to the next lower fullword. 

If hexlod is not specified, the display begins at 
storage location 0. If L, T, or K are entered either 
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without any operands, or followed immediately by a 
blank, the contents of all storage locations or all the 
storage keys are displayed. If L, T, or K are not 
specified and this is the first operand, then the 
default value of zero is assumed. The address, 
hexlod, may be one to six hexadecimal digits; leading 
zeros are optional. 

hexloc2 is the last of the range of hexadecimal storage 
locations whose contents are to be displayed at the 
terminal. Either a - or a : must be specified to 
display the contents of more than one location by 
storage address. If hexloc2 is not specified, the 
contents of all storage locations from hexlod to the 
end of virtual storage are displayed. If specified, 
hexloc2 must be equal to or greater than hexlod and 
within the virtual storage size. (See Usage Notes 
below for a discussion on discontiguous shared 
segments.) The address, hexloc2, may be from one to 
six hexadecimal digits; leading zeros are optional. 

{ . Jbytecount is a hexadecimal integer designating the number of 
END bytes of storage (starting with the byte at hexlod) to 

be displayed at the terminal. The period (.) must be 
specified to display the contents of more than one 
storage location by bytecount. The sum of hexlod and 
bytecount must be an address that does not exceed the 
virtual machine size. (See Usage Notes below for a 
discussion on discontiguous shared segments.) If this 
address is not on a fullword boundary, it is rounded up 
to the next higher fullword. The value, bytecount, 
must have a value of at least one and may be from one 
to six hexadecimal digits; leading zeros are optional. 

Gregl is a decimal number from to 15 or a hexadecimal 

integer from to F representing the first, or only, 
general register whose contents are to be displayed at 
the terminal. If G is specified without a register 
number, the contents of all the general registers are 
displayed at the terminal. 

Yregl is an integer (0, 2, 4, or 6) representing the first, 

or only, floating-point register whose contents are to 
be displayed at the terminal. If Y is specified 
without a register number, the contents of all of the 
floating-point registers are displayed at the 
terminal. 

Xregl is a decimal number from to 15 or a hexadecimal 

number from to F representing the first, or only, 
control register whose contents are to be displayed at 
the terminal. If X is specified without a register 
number, the contents of all of the control registers 
are displayed at the terminal. If Xregl is specified 
for a virtual machine without extended mode operations 
available, only control register is displayed. 



/-Vreg2 
t : I E MD 



is a number representing the last register whose 
contents are to be displayed at the terminal. Either a 
- or a : must be specified to display the contents of 
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more than one register by register number. If reg2 is 
not specified, the contents of all registers from regl 
through the last register of this type are displayed. 
The operand, reg2, must be equal to or greater than 
regl. If Gregl or Xregl are specified, reg2 may be a 
decimal number from 0-15 or a hexadecimal number from 
0—F. If Yregl is specified, reg2 may be 0, 2, 4, or 
6. The contents of registers regl through reg2 are 
displayed at the terminal. 

{ . }regcount is a decimal number from 1 to 16 or a hexadecimal 
END number from 1 to F specifying the number of registers 

(starting with regl) whose contents are to be displayed 
at the terminal. If the display type G or X is 
specified, regcount can be a decimal number from 1 to 
16 or a hexadecimal number from 1 to F. If display type 
Y is specified, regcount must be 1, 2, 3, or 4. The 
sum of regl and regcount must be a number that does not 
exceed the maximum register number for the type of 
registers being displayed. 

PSW displays the current virtual machine PSW (program 

status word) as two hexadecimal words. 

CAW displays the contents of the CAW (channel address word 

at hexadecimal location 48) as one hexadecimal word. 

CSW displays the contents of the CSW (channel status word 

at hexadecimal location 40) as two hexadecimal words. 



H§§3e Notes 

1. Only first level storage (storage that is real to the virtual 
machine) can be displayed. Operating systems such as DOS/VS and 
OS/VS have virtual storage of their own. This second level virtual 
storage cannot be displayed directly. The user or the virtual 
operating system is responsible for converting any second level 
storage locations to first level storage locations before issuing 
the command. 

2. If a command line with an invalid operand is entered, the DISPLAY 
command terminates when it encounters the invalid operand; however, 
any previous valid operands are processed before termination 
occurs. Multiple storage locations, registers, and control words 
can be displayed using a single command line. 

3. When multiple operands are entered on a line for location or 
register displays, the default display type is the same as the 
previous explicit display type. The explicit specification of a 
display type defines the default for subsequent operands for the 
current display function. Blanks are used to separate operands or 
sets of operands if more than one operand is entered on the same 
command line. Blanks must not be used to the right or left of the 
range or length delimiters (: or - or .) , unless it is intended to 
take the default value of the missing operand defined by the blank. 
For example: 

display 10 20 T40 80 G12 5 L60-100 
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displays the following, respectively: 

hexadecimal location 10 

hexadecimal location 20 

hexadecimal location 40 with EBCDIC translation 

hexadecimal location 80 with EBCDIC translation 

general register 12 

general register 5 

hexadecimal locations 60 through 100 

4. To terminate the DISPLAY function while data is being displayed at 
the terminal, press the Attention key (or its eguivalent) . When 
the display terminates, another command may be entered. 

5. The DISPLAY command does not distinguish between shared and 
non-shared storage; it displays any of the virtual machined 
addressable storage whether shared or not. 

6. Use the DISPLAY command to display the contents of various storage 
locations, registers, and control words at the terminal. By 
examining this type of information during the program^ execution, 
you may be able to determine the cause of program errors. Usually, 
an address stop is set to stop the program execution at a specified 
point. The system enters the CP environment and you may then issue 
the DISPLAY command. 

7. When you must examine large portions of storage, use the DUMP 
command rather than the DISPLAY command. Because the terminal 
operates at a much slower speed than the printer, only limited 
amounts of storage should be printed (via the DISPLAY command) at 
the terminal. 

8. When running with a discontiguous saved segment (DCSS) , you can 
display storage locations outside the range of your virtual machine 
size if they are within the DCSS. If there exist locations between 
the upper limit of your virtual machine and the address at which 
the DCSS was saved, an attempt to display those locations (or 
associated keys) will result in a "non-addressable storage" 
message. 



Responses 

One or more of the following responses is displayed, depending upon the 
operands specified. 



Pi§El§;lifia Storage Locations 

xxxxxx wordl word2 word3 word4 [key] *EBCDIC TRANSLATION* 

This is the response you receive when you display storage 
locations; xxxxxx is the hexadecimal storage location of wordl. 
Wordl is displayed (word-aligned) for a single location 
specification. Up to four words are displayed on a line, followed, 
optionally, by an EBCDIC translation of those four words. Periods 
are represented by nonprintable characters. Multiple lines are 
used (if reguired) for a range of locations. If translation to 
EBCDIC is reguested (Thexloc) , alignment is made to the next lower 
16-byte boundary:; otherwise, alignment is made to the next lower 
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fullword boundary. If the location is at a 2K page boundary, the 
key for that page is also displayed. 



Displaying Storage Keys 

xxxxxx TO xxxxxx KEY = kk 

This is the response you receive when you display storage keys; 
xxxxxx is a storage location and kk is the associated storage key. 



displaying General Registers 

GPR n = genregl genreg2 genreg3 genregU 

This is the response you receive when you display general 
registers; n is the register whose contents are genregl. The 
contents of the following consecutive registers are genreg2, 
genreg3, and so on. The contents of the registers are displayed in 
hexadecimal, up to four registers per line are displayed fcr a 
range of registers. Multiple lines are displayed if reguired, with 
a maximum of four lines needed to display all 16 general 
registers. 



Displaying Ii2il£iliSzi!2i3l£ Insist ers 



FPR n = xxxxxxxxxxxxxxxx . xxxxxxxxxxxxxxxxx E xx 

This is the response you receive when you display floating-point 
registers; n is the even-number floating-point register whose 
contents are displayed on this line. The contents of the reguested 
floating-point registers are displayed in both the internal 
hexadecimal format and the E format. One register is displayed per 
line. Multiple lines are displayed for a range of registers. 



displaying Control Registers 

ECR n = ctlregl ctlreg2 ctlreg3 ctlregU 

This is the response you receive when you display control 
registers; n is the register whose contents are ctlregl. The 
contents of the following consecutive registers are ctlreg2, 
ctlreg3, and so on. The contents of the reguested control 
registers are displayed in hexadecimal. Up to four registers per 
line are displayed. Multiple lines are displayed if reguired. 



Displaying the PSW 

PSW = xxxxxxxx xxxxxxxx 

The contents of the PSW are displayed in hexadecimal. 
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Si§E!i!lil!£l i^e CAW 
CAW = XXXXXXXX 

The contents of the CAW (hexadecimal location 48) are displayed in 
hexadecimal. 



PiSElaiing the CSW 

CSW = XXXXXXXX XXXXXXXX 

The contents of the CSW (hexadecimal location 40) are displayed in 
hexadecimal. 
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DUMP 



P£ixii63§ Class: G 

Use the DUMP command to print the contents of various components of the 
virtual machine on the virtual spooled printer. The following items are 
printed: 

• Virtual program status word (PSW) 

• General registers 

• Floating-point registers 

• Control registers (if you have the ECMODE option specified in your 
VM/370 directory entry) 

• Storage keys 

• Virtual storage locations (1st level virtual storage only; see Usage 
Notes.) 

Note: Use the NETWOBK DUMP command to dump the contents of 3704/3705 
storage. This command is described in the VM^370: O^erator^s Guide. 

The format of the DUMP command is: 



DUMP 



ILhexlod | |(-\ |hexloc2 | 

|Thexloc1| |\: || END | 

I hexlod || l J 

I | | r t 
L J l{- }|bytecount | 

I I MD | 

L L J 



[*dumpid ] 



where : 

Lhexlod 
Thexlod 
hexlod 




is the first or only hexadecimal storage location to 
be dumped. If you enter L or T without operands, the 
contents of all virtual storage locations are dumped. 

The address, hexlod, may be one to six hexadecimal 
digits; leading zeros are optional. If hexlod is not 
specified, the dump begins at storage location 0. 



If hexlod is not on a fullword boundary, 
down to the next lower fullword. 



it is rounded 



/ -\hex 



hexloc2 



is the last hexa 
are to be dumped 
must be egual to 
virtual storage s 
can specify END 
field blank, sin 
:END or -END, the 
are dumped. The 
through hexloc2 
the printer. The 
hexadecimal digit 



decimal storage location whose contents 

to the printer. The operand, hexloc2, 

or greater than hexlod and within the 

ize. To dump to the end of storage, you 

instead of hexloc2 or you can leave the 

ce the default is END. If you specify 

contents of storage from hexlod to END 

contents of storage locations hexlod 

are printed with EBCDIC translation at 

operand, hexloc2, may be from one to six 

s; leading zeros are optional. 
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{ . }bytecount is a hexadecimal integer designating the number of bytes 
END of storage (starting with the byte at hexlod) to be 
dumped to the printer. The period (.) must be specified 
to dump the contents of more than one storage location by 
bytecount. The sum of hexlod and bytecount must be an 
address that does not exceed the virtual machine size. 
If this address is not on a fullword boundary, it is 
rounded up to the next highest fullword. The value, 
bytecount, must be one or greater and can be no longer 
than six hexadecimal digits. Leading zeros are 
optional. 

♦dumpid can be entered for descriptive purposes. If specified, 
it becomes the first line printed preceding the dump 
data. Up to 100 characters, with or without blanks, may 
be specified after the asterisk prefix. No error 
messages are issued, but only 100 characters are used, 
including asterisks and embedded blanks. 

Usage Notes 

1 . Only first level storage (storage that is real to the virtual 
machine) can be dumped. Operating systems such as DOS/VS and OS/VS 
have virtual storage of their own. This second level virtual 
storage cannot be dumped directly. The user or the virtual 
operating system is responsible for converting any second level 
storage locations to first level storage locations before issuing 
the command. 

2. The CP DUMP command executes in an area of storage separate from 
your virtual machine storage and does not destroy any portion of 
your storage. 

3. The DUMP command prints the virtual PSH and the virtual registers 
(general, floating-point, and control) . If only this information 
is desired, at least one virtual address must be specified, such as 

DUMP 

4. The output format for the virtual storage locations is eight words 
per line with the EBCDIC translation on the right. Each fullword 
consists of eight hexadecimal characters. All the rest of the 
information (PSW, general and floating-point registers, and storage 
keys) is printed in hexadecimal. If you have the ECMODE option in 
your VM/370 directory entry, the control registers are also 
printed. To print the dump on the real printer, a CLOSE command 
must be issued for the spooled virtual printer. 

5. Normally, you should define beginning and ending dump locations in 
the following manner:, 

dump Lhexloc1-hexloc2 

dump Lhexlod .bytecount 

dump Lhexlod-hexloc2 hexlod .bytecount * dumpid 

If, however, a blank follows the type character (L or T) or the 
character and the hexloc, the default dump starting and ending 
locations are assumed to be the beginning and/or end of virtual 
storage. Blanks are used to separate operands or sets of operands 
if more than one operand is entered on the same command line. 
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Blanks must not be used to the right or left of range or length 
delimiters ( : or - or . ) , unless it is intended to take the 
default value of the missing operand defined by the blank. Thus, 
all of the following produce full storage dumps: 



dump 1 dump t: dump 0-end 

dump t dump 1. dump l:end 

dump - dump t. dump t:end 

dump : dump 0- dump 0:end 

dump . dump 0: dump Lend 

dump 1— dump 0. dump t.end 

dump t- dump 1-end dump O.end 

dump 1: dump t— end 



The following produces three full dumps: 

dump 1 . t 
dump — . : 

When running with a discontiguous saved segment (DCSS) , you can 
dump storage locations outside the range of your virtual machine 
size if they are within the DCSS. If there exist locations between 
the upper limit of your virtual machine and the address at which 
the DCSS was saved, an attempt to dump those locations (or 
associated keys) will result in a "non-addressable storage" message 
appearing in the printer output. 



Responses 

As the dump progresses, the following message is displayed at the 
terminal; indicating that the dump is continuing from the next 64k 
boundary: 

DUMPING LOC hexloc 

where hexloc is the segment (64K) boundary address for the dump 
continuation, such as 020000, 030000, or 040000. 

If you press the Attention key, or its equivalent, on the terminal 
while the message is being displayed, the dump function is 
terminated. 

COMMAND COMPLETE 

is the response indicating normal completion of the dump function. 
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ECHO 

E£ivi-!§2§ Class: G 

Use the ECHO command to place the terminal in the echo environment. 
When in the echo environment, any input line entered is transmitted 
unchanged back to the terminal a specified number of times. The format 
of the ECHO command is: 



I 
I 



where :: 

nn is the number of times the line is to be sent. The default is 
1. An invalid entry (that is, one that is greater than 99 or 
contains non-numeric characters) is treated as 1. 



Osajje Notes 

1. When the specified number of lines has been displayed, another read 
to the terminal is issued to accept another data line. 

2. To terminate the display before completion (for example, when you 
want to change the data line) , press the Attention key (or its 
eguivalent) . 

3. No line editing is done; thus, the output line is the same as the 
input line and may contain any of the logical line editing 
symbols. 



Responses 

ECHO ENTERED; TO TERMINATE TEST, TYPE END 

is displayed after the ECHO command is invoked to indicate that the 
echo environment has been entered. 

ENTER LINE 

is displayed to request an input line to be entered. A reply of 
END returns the terminal to the CP command environment. 
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EXTERNAL 

Privilege Class: G 

Use the EXTERNAL command to simulate an external interruption to the 
virtual machine and return control to that machine. The format of the 
EXTERNAL command is: 



I I r -i I 

I EXTernal | |code| I 

I I I i£0 | I 

I I L J I 



where: 

code is the interruption code, a hexadecimal number to be 
associated with the external interruption. All codes less 
than or equal to X'FF 1 are valid. If your virtual machine has 
the ECMODE option specified in the VM/370 directory, you can 
also code 1004 (clock comparator interrupt) or 1005 (CPU Timer 
interrupt) . The default is the External Interrupt Button on 
the system console, X'40 1 . 



M§age Notes 

1. This simulates pressing the interrupt key on the real computer 
console, or other functions which cause an external interruption. 
Control is given to the virtual machine immediately. 



Responses 

None. since control is given to the virtual machine, any response is 
from virtual machine processing. 
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INDICATE 

E£i2i!§2«i Class: G 

Use the INDICATE command to display, at your terminal, the use of and 
contention for major system resources. The format of the INDICATE 
command is: 



I I r i 

I INDicate | I LOAD | 

I I I USER] 

1 I L J 



where : 

LOAD displays CPU use, CPU contention, main storage use, and main 
storage contention. 

USER displays the amounts of system resources used by your virtual 
machine in the current terminal session. 



Usage Notes 

1. Use INDICATE LOAD to display system load conditions. 

2. Use INDICATE USER to display the total amount of certain resources 
used by your virtual machine during the current terminal session. 
Use the INDICATE USER command before and after the execution of a 
program to indicate the execution characteristics of that program 
in terms of the resources used. 



lesponse for INDICATE LOAD 

CPU-nnn% Q1-nn Q2-nn STORAGE-nnn* RATIO-n.n 

where : 

CPU-nnnX represents the percentage of time that the VM/370 system 
is running, that is, not waiting. 

Ql-nn Q2-nn represent the contention for the CPU in terms of the 
average number of active users both interactive (Q1) and 
non-interactive (Q2) . 

STORAGE-nnnX is a measure of real storage use. It represents an 
average ratio of the combined working sets of the active 
users to the total number of pageable pages in the system. 
It is possible for nnn to exceed 100. (This is a function 
of system load and VM/370's user scheduling algorithm). 
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RATIO-n.n represents the contention for real storage. It is defined 
as: 

E+M 

RATIO = 

H 

where : 

E is the number of users that are eligible to become 
active when enough storage becomes available. 

M is the number of users currently active. 

Thus, RATIO is the ratio of potential users to users 
currently active. It is 1.0 for optimum response. Optimum 
response occurs when enough storage exists to accommodate 
all potential users, assuming that the system at this time 
is not CPU bound. 

If E and M are both zero, the value of RATIO is set to 
1.0. 

Given the values of RATIO and M (M = Q1 + Q2) , the number 
of users waiting to become active can be calculated as: 

E = M (RATIO -1) 



Response for INDICATE USER 

PAGES: RES-nnnn WS-nnnn READS=nnnnnn WRITES=nnnnnn DISK-nnnn DRUM-nnnn 
VTIME=mmm:ss TTIME=mmm:ss SIO=nnnnnn RDR-nnnnnn PRT-nnnnnn PCH-nnnnnn 

where : 

RES-nnnn is the current number of your virtual storage pages 

resident in main storage. This number is taken at an 

instant of time during the execution of the INDICATE 
command. 

WS-nnnn is the most recent system estimate of your working set 
size. 

READS=nnnnnn is the total number of page reads that have occurred for 
you since you logged on or since the last ACNT command was 
issued for your virtual machine. 

WRITES=nnnnnn is the total number of pages written for you since you 
have logged on or since the last ACNT command was issued 
for your virtual machine. 

DISK-nnnn is the current number of virtual pages allocated for you 
on the system paging disk (s) . This number is taken at an 
instant of time during the execution of the INDICATE 
command. 

DRUM-nnnn is the current number of virtual pages allocated for you 
on the system paging drum (s) . This number is taken at an 
instant of time during the execution of the INDICATE 
command. 
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VTIME=mmm:ss is your total virtual machine time since you logged on or 
since the last ACNT command was issued for your virtual 
machine. 

TTIME=mmm :ss is your total virtual machine time plus total CPU time 
(virtual plus overhead) that you have used since you 
logged on or since the last ACNT command was issued for 
your virtual machine. 

SIO=nnnnnn is the total number of non-spooled I/O reguests that you 
have issued since you logged on or since the last ACNT 
command was issued for your virtual machine. 

RDR-nnnnnn is the total number of virtual cards read since you logged 
on or since the last ACNT command was issued for your 
virtual machine. 

PRT-nnnnnn is the total number of virtual lines printed since you 
logged on or since the last ACNT command was issued for 
your virtual machine. 

PCH-nnnnnn is the total number of virtual cards punched since you 
logged on or since the last ACNT command was issued for 
your virtual machine. 
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IPL 



IlEivilecje Class: G 



Use the IPL command to simulate an initial program load function for a 
virtual machine. The format of the IPL command is: 



I pi 



r i 

ICLear | 
vaddr [cylno] |NOCLear| [STOP] \ [PARM {pi p2...}] 

L J 



systemname 



where : 

r n 

vaddr [cylno] |CLEAR | [STOP] 
INOCLEARI 

L J 

simulates the IPL function when loading by device address. 

vaddr is the virtual address (cuu) of the device that contains the 
nucleus to be loaded. 

cylno is the cylinder containing the IPL data. If this operand is 
specified, CP loads the IPL data from the specified virtual 
cylinder instead of from virtual cylinder zero. Virtual 
cylinder zero is the default when cylno is not specified. 
This operand is valid only for virtual direct storage 
devices. 



CLEAR 



NOCLEAR 



STOP 



sets the virtual storage space to binary zeros before the 
operating system is loaded. This operand is invalid if you 
specify a systemname in the IPL command line. 

allows the contents of your virtual storage space to remain 
unchanged prior to program load. This operand is invalid if 
you specify a systemname in the IPL command line. NOCLEAR is 
the default if you IPL by device (vaddr) . 



halts the vi 
the initial 
of the IPL 
mode. The S 
in the IPL 
issue CP com 
into your v 
data into 1 
alter the a 
virtual mach 



rtual mach 
PSW is loa 
procedure 
TOP operan 
command, 
mands. For 
irtual mac 
ow stroage 
pparent si 
ine, issue 



ine during 
ded. It p 
for a rea 
d is inva 
When the v 

example, 
nine, you 
, to load 
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the BEGIN 



the 
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if yo 
can 

an 
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IPL proce 
es the vi 
hine in 
f systemn 
1 machine 
u are loa 
use CP co 
alternate 
storage, 
and. 



dure just before 

rtual simulation 

instruction step 

ame is specified 

stops, you can 

ding OS or OS/VS 

mmands to store 

nucleus, or to 

To restart the 



systemname 



simulates the IPL function when loading a named system that 
was previously saved via the SAVESYS command. It is loaded 
into virtual storage and given control. For more information 
about saved systems, see the VM^370: System Programmer's 
Guide. 



Section 5. Format of CP Commands 75 



IPL 

Note: You cannot load a saved system into a virtual=real 
virtual machine. An attempt to do so results in an error 
message. 

PARM {p1 p2... } 

passes up to 64 bytes of data (including embedded blanks) to 
your virtual machine 1 s general registers (4 bytes per 
register) , starting with the high order byte of general 
register 0. Whenever PARM is specified, the remaining 
characters in the command line are treated as parameters to be 
passed to your virtual machine; therefore, PARM must be the 
last operand entered on the command line. 



Usa^e Notes 

1. IPL simulates the LOAD button and the device address switches on 
the real computer console. The specified virtual address is 
accessed and the reguired input/output operations are performed to 
retrieve the IPL data. 

2. Optionally, the IPL procedure can be stopped just before loading 
the virtual PSW except when initial program loading a named 
system. Also, parameters can be passed to the virtual machine's 
general registers. When the simulated load function is complete, 
CP initiates execution of the virtual machine by loading the IPL 
PSW which was stored during the simulation process. 

3. Care must be used when passing parameters to a named system 

(systemname) . Named systems expect certain registers to be 
initialized when they are given control. Indiscriminate use of the 
PARM option could overlay a previously initialized register causing 
unpredictable results. 

4. The IPL simulator program occupies one page (4096 bytes) of storage 
in your virtual machine. Therefore, if the system being loaded 
utilizes data remaining in storage by the previous system, care 
should be taken as to where that data is located. The starting 
address of the overlayed virtual storage is: 

virtual machine size 

or hexadecimal 20000 

2 
whichever is smaller. 

5. Any logical lines following the IPL command are ignored since the 
execution of the IPL command transfers control from the CP 
environment to the virtual machine environment. 



Responses 

After a successful IPL, any responses you receive are those from the 
operating system that was loaded and initialized. 
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LINK 

££iv±i§a§ Class: G 

Use the LINK command to make a device that is associated with another 
virtual machine, available to your virtual machine configuration, based 
upon information in that user's VM/370 directory entry. The format of 
the LINK command is: 

| LINK | [To] userid vaddrl [As] vaddr2 [mode] [[PASS=] password] | 

wh er e : 

[TO - ] userid is the name of the user whose VM/370 directory is to be 

searched for device vaddrl. An asterisk (*) is used to 

specify that the device is in your own VM/370 directory. 

If the keyword TO is omitted, the userid may not be TO or 

T. 

vaddrl is the virtual device address (cuu) in the VM/370 
directory for that userid. 

[AS] vaddr2 is the virtual address (cuu) which is to be assigned to 
the device for your virtual machine. If the keyword AS is 
omitted, vaddr may not be AS or A. If your virtual 
machine has the ECMODE option, any address up to X'FFF' 
is valid; otherwise, any address up to X'5FF' is valid. 

mode is the access mode; the primary access reguested 

(read-only, write, or multiple) , and the alternate access 
(read-only or write) desired if the primary access is not 
available. Valid modes are: 

Mode Meaning 

R Read-only access. The link is not done if any other 
user has the disk in write status. R is the default 
mode if the link is to another userid. 

RR Read-only access. The link is established even if 
another user has the disk in write status. 

W Write access. The link is not done if any other user 
has the disk in read or write status. 

WR Write and read access. If another user has the disk 
in read or write status, an alternate access of 
read— only is acceptable. 

M Multiple access. This means that a write-link is to 
be given to the disk unless another user already has 
write access to it, in which case no link is to be 
done. 

MR Write-link. If another user already has write access 
to the disk, a read-link is to be done. 

Note: Unpredictable results can occur when one user 
has a R/0 link to a device that is being updated by 
a user who has the device in R/W status. 

MW Write-link. This link is established in all cases. 
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I Caution: More than one user writing to the same 

I virtual device can result in permanent loss of 

I data. 

If the mode is omitted, the default is R if the userid is 
another user. If you are linking to one of your own 
disks,, the default is the "user access mode" as specified 
in the VM/370 directory for your disks. 

PASS= password is a one- to eight-character string that must match the 
access mode password for device vaddrl in the VM/370 
directory for the user (userid) specified. The password 
should be specified only when the LINK is executed by a 
virtual machine (for example, from CMS), since the 
password is not print suppressed when included with the 
LINK command. The password cannot be the same as any of 
the access modes (R, RR, W, WR, M, MR, or MW) if the 
default mode is to be used. 

Note: The access mode password should not be confused 
with a user password. 



Usajje Notes 

1. If you link to one of your own disks, no password is reguired. 
Also, if the link is to a device whose password is ALL, meaning 
that the device can be used by all users, the password is not 
reguired. However, if the link is to any other userid, a password 
for the desired device must be provided. 

2. The access allowed by the LINK command to the vaddrl device 
belonging to userid is summarized below. You read the columns down 
to determine the type of link that results. The first row 
indicates the primary (and, optionally, the alternate) access mode 
reguested. The second row indicates whether read, write, or 
multiple passwords exist in the VM/370 directory for the disk being 
linked. The third row indicates whether the disk is already being 
used, and if so, the mode of its access. The last row indicates 
the type of link established. For example, the third column is 
interpreted as follows: if you reguest a read access link (R) to a 
disk that has a read password defined and that already is accessed 
in read mode, you can establish a read link. 



| Primary access reguested: RRRRR HWHWHW MMMMMM 
I Alternate access (if any): R R R R W 



| Read password in directory: N Y Y Y Y 

| Write password in directory: N Y Y Y Y Y 

| Mult, password in directory: N Y Y Y Y Y 

| Any existing links: NRWW NRRHW NRWWW 

| Access established: NRRNR NWNRNR NWWNRW 



| where: H=no or none? R=read; W=write; M=multiple; Y=yes 
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Responses 

ENTER READ PASSWORD: 
KKKKfifiKK 

Type the read password over the mask to obtain read access to the 
desired disk. 

ENTER WRITE PASSWORD: 
KHKMXKHM 

Type the write password over the mask to obtain write access to the 
desired disk. 

ENTER MULT PASSWORD: 
BKKHHMKK 

Type the multiple password over the mask to obtain write access to 
a disk for which other users may already have access. 

Note: If LINK is issued from a virtual machine with the password 
included on a command line, and the password is incorrect, then CP 
counts these incorrect passwords. If a total of ten such incorrect 
passwords is entered, the LINK command from a virtual machine is 
subsequently disallowed for that user for the remainder of the 
session. LINK can still be issued directly from the terminal (that 
is, in CP command mode) , or the LINK command can be reinstated as a 
valid command from your virtual machine by logging off and logging 
on again. (This procedure is designed to protect password security 
if a virtual machine issues the LINK command repeatedly with trial 
passwords. ) 

DASD vaddr2 LINKED R/0 

This response indicates that a read-only link to the given disk is 
established for a LINK request with a mode of R or RR, and that no 
other users are linked to the same disk in read/write mode. 

DASD vaddr2 LINKED R/W 

This response indicates that a read/write link to the given disk is 
established for a LINK request with a mode of W, WR, M, MR, or MW, 
and that no other users are linked to the same disk. 

r t 

DASD vaddr2 LINKED R/0; R/W BY ( nnn USERS)|; R/0 BY ( nnn USERS) | 

I userid j| (userid j\ 

L J 

This response indicates that a read-only link to the given disk is 
established for a LINK request with a mode of RR, but warns that 
the disk is in read/write use by some users and possibly in read 
use by some users. If only one user has access, the number of users 
(nnn USERS) is replaced by userid. 

DASD vaddr2 LINKED R/W; R/0 BY | nnn USERS) 

\ userid / 

This response indicates that a read/write link to the given disk is 
established for a LINK request with a mode of M, MR, or MW, and 
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informs you that the disk is also in read-only use by userid or by 
nnn users. (No other users have a read/write link to the disk.) 

r i 

DASD vaddr2 LINKED R/W; R/W BY ( nn USERS) |; R/0 BY /nnn USERS) | 



( nn USERS) | ; R/0 BY jn 
\ userid j | \u 



serid j | 

L J 

This response indicates that a read/write link to the given disk is 
established for a LINK request with a mode of MW, but warns you 
that the disk is also in read/write use by some users and possibly 
in read use by some users. If only one user has access, the number 
of users (nnn USERS) is replaced by userid. 
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LOADVFCB 

PEiXiiefle Class: G 

Use the LOADVFCB command to specify the forms control buffer image for a 
virtual spooled 3211 printer. The format of the LOADVFCB command is: 

| LCADVFCB | vaddr FCB name [Index [ nn ] ] I 

where : 

vaddr is the virtual device address (cuu) of the virtual spooled 
3211 printer. 

FCB is a required reserved keyword meaning Forms Control Buffer. 

name is a system-defined name for the 3211 FCB image which is to be 
the controlling virtual FCB image. 

INDEX [nn] 

is the number of the print position that is the first print 
position. The value, nn, must be a number from 1 through 31; a 
leading zero need not be specified. If the keyword INDEX is 
specified without a value, the index defaults to the value 
specified in the FCB macro. See the XH/370: System 
££23£§S!l§£ls Guide for a discussion of the FCB macro and forms 
control images. 



Usage Notes 

1. The LOADVFCB command can be used with installations that do not 
have a 3211 printer. The virtual machine's VM/370 directory entry 
must indicate a 3211, even though the program and operating system 
have a 1403 printer defined. Then the LOADVFCB command can be used 
to specify a virtual FCB image for 1403 printers so that programs 
that use printer overflow sensing may be spooled to disk. 

2. VM/370 provides one FCB image called FCB1 with the following 
format : 

| Line spacing = 6 lines/inch 



| Length of page = 66 lines 

IPage line | 1| 3| 5| 7| 9| 11| 13| 15| 19| 21| 23 | 6U 
I I I I I I I I I I I I I 



Responses 
None. 
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LOGOFF 

Privilege Class: Any 

Use the LOGOFF command to terminate virtual machine execution and 
disconnect your virtual machine from the VM/370 system. The format of 
the LOGOFF command is : 

| LCGoff | [HOld] | 

| LOGout | | 

where : 

HOLD retains the connection for a switched communication line to 
enable you to log on without redialing the VM/370 system. 



fisage Notes 

I. This command causes all active spool files to be closed, temporary 
disks to be relinguished, dedicated devices to be detached, and an 
accounting record to be created for the user. 

2. You should always log off of your terminal in addition to turning 
power off on the terminal. Terminal power off is not synonymous 
with logoff. 

If you turn power off at the terminal instead of logging off, 
logoff occurs by one of the following methods: 

* 3LXE§ writer Terminal and Remote 3270 Display Terminal --Logoff 
takes place after a 15-minute interval has elapsed. This occurs 
if no attempt is made to power on the terminal and re-establish 
communications with the still logged-on virtual machine during 
this 15-minute period. 

• Local 3270 Display. Terminal — Logoff only takes place 15 minutes 
after VM/370 discovers that the terminal has been turned off 
(that is, VM/370 attempts to send a message to the terminal, but 
gets back an error code indicating that the terminal is turned 
off) . Because many hours may pass before VM/370 discovers that 
the terminal is turned off, you run the risk of compromising the 
security of the virtual machine and data files. Anyone turning 
the 3270 power back on has access to the virtual machine without 
logging on. This is because the machine is still logged on, 
although inactive. 



Responses 

C0NNECT= hh:mm:ss VIRTCPU= mmm:ss.hs TOTCPU= mmm:ss.hs 

where : 

CONNECT=hh:mm:ss 

is the actual clock time spent in the current terminal session 
in hours: minutes:seconds. 
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VIETCPU=hh:mm:ss 

the virtual CPU time used in the current terminal session in 
minutes:seconds. hundredths of seconds. 

TOTCPU=hh:mm:ss 

the total CPU time (including virtual and overhead) used in 
the current terminal session in minutes:seconds. hundredths of 
seconds. 

These times are either the elapsed time for the entire terminal 
session or the elapsed time since the ACNT command was entered for 
this user. 

LOGOFF AT hh:mm:ss zone weekday mm/dd/yy 
is the response for a logoff. 

(GRAF raddr) 

< LINE raddr > LOGOFF AS userid USERS = nnn 

( DEV rid ) 

is the normal response to the primary system operator. DEV rid 
specifies the resource identification of a 3704/3705 line. 

(GRAF raddr ) 

; LINE raddr J. LOGOFF AS userid USERS = nnn FORCED 

| DEV rid j 

is the response to the primary system operator if the logoff is 
forced by a line timeout or a terminal power-off. DEV rid 
specifies the resource identification of a 3704/3705 line. 

USER DSC LOGOFF AS userid USERS = nnn 

is the response to the primary system operator when logoff occurs 
for a user who had previously disconnected using the DISCONN 
command. 
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LOGON 

lEiXilege Class: Any 

Use the LOGON command to identify yourself to the VM/370 system and to 
access that system. The format of the LOGON command is: 



| Logon | userid [password] [Mask] [Noipl] I 

| Login | | 



where :: 

userid is the identifier assigned to you in the VM/370 system. 

password is your password. Specify this field if no protection (that 
is, masking characters) is desired. 

MASK types masking characters to cover your password on typewriter 
terminals without the print inhibit feature. The mask types on 
the line following a prompting message from VM/370 requesting 
you to enter your password. Should you forget to ask for 
masking when you type LOGON, you can press the carriage return 
after the prompt for the password types, and VM/370 then types 
out the masking characters. 

NOIPL specifies that the IPL device or name in the VM/370 directory 
should not be used for an automatic IPL. 



5§age Notes 

1. Upon successful logon, VM/370 creates a virtual machine 
configuration from information in the VM/370 directory. The LOGON 
command name may not be entered using any line-editing symbols, but 
the operands may use these symbols. See the VM^370: Terminal 
JJserJ.s Guide for a detailed description of logon procedures. 

2. If you use LOGON because a teleprocessing line or terminal error 
disconnected you from your virtual machine, you have 15 minutes to 
log on again. If you do not log on within 15 minutes, your virtual 
machine automatically logs off. In this case, you may have to 
reconstruct files and restart jobs interrupted by the 
teleprocessing line or terminal error. 



Responses 

ENTER PASSWORD: 

indicates that the userid has been accepted. You should type in 
the password, or signal a carriage return if a mask is desired for 
the password, and MASK was not included on the command line. 
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LOGMSG- hh:mm:ss mm/dd/yy 

indicates the time and date at which the system log message was 
generated or most recently revised. All lines of the log message 
for which the first character is an asterisk are displayed at this 
point. If you wish to see all of the system log messages, you must 
issue the CP command QUERY LOGMSG. 



FILES 



: fnnnl RDR, fnnn) PRT, J nnn) 
(NO / (NO / ( NO / 



PUN 



This message is omitted if all counts are zero, otherwise it 
indicates the number of spool files that exist for you at logon 
time. 



LOGON AT hh:mm:ss zone weekday mm/dd/yy 

— or — 

RECONNECTED AT hh:mm:ss zone weekday mm/dd/yy 

indicates the time, day of the week, and date at which the LOGON or 
RECONNECT is complete. 



GRAF raddr) 

LINE raddr> LOGON AS userid 

DEV resid) 



USERS = nnn 



— or — 



GRAF raddr) 

LINE raddr > RECONNECT userid 

DEV resid) 



USERS = nnn 



is the response to the primary system operator. DEV resid 
specifies the resource identification of a 3704/3705 line. 
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Privilege Class: Any 

Use the MESSAGE command to transmit message text to a specified userid 
or to the primary system operator. The format of the MESSAGE command 
is: 



| Message | ( userid ) msgtext I 

i <J * \ i 



operator 



I Msg | 
I I 

where : 

userid is the identification of the user who is to receive the 
message. 

* specifies that you are sending a message to yourself. 

OPERATOR sends the message to the primary system operator regardless of 
his userid. 

msgtext is the text of the message which is to be transmitted. The 
length of the message is limited only by the number of 
characters remaining on the input line. 



Usage Notes 

1. If the user designated to receive the message is not logged on or 
has suppressed the receiving of messages (SET MSG OFF) , the message 
is not transmitted and the sender receives a diagnostic message to 
this effect. A message which is not received by a user is not 
saved and must be sent at a later time when the user is receiving 
messages. 

2. The message is displayed at the terminal when the terminal is ready 
to receive output. If a typewriter terminal (or a display terminal 
having AUTOREAE set ON) is entering data, the message is not 
displayed until an end— of— line (carriage return or ENTER) signal is 
received. 

3. If the message is received by the primary system operator console 
and SET MSG ON is in effect, the alarm at the central computer 
console sounds. 

4. If the user receiving the message is logged on with a 3277 virtual 
console that has the alarm feature, the alarm sounds. 

5. MSG * is useful in identifying the current userid of an abandoned 
terminal, or it can be used in a program intended to be executed 
under several userids. 
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Responses 

hh:mm:ss 

MSG FROM OPERATOR: msgtext 

is the message received by the user from the system operator. 

hh: mm:ss 

MSG FROM (LOGONxxx]: msgtext 

<userid > 

(lOGNxxxx) 

is the format of the message sent to another user or to the 
system operator, where userid is that of the sender. If the 
user sending the message is not logged on to VM/370, LOGON or 
LOGN and the line number are displayed instead of userid. 



hh: mm:ss 



is the time in hours: minutes: seconds when the message was sent 
to the user. 
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PEizii§a§ Class: G 

Use the NOTREADY command to cause a virtual device to appear as if it 
had changed from ready to not ready status. The format of the NOTREADY 
command is: 



| NOTReady | vaddr I 



where: 

vaddr is the virtual device address (cuu) of the unit to be removed 
from ready status. 



M§»a<je Notes 

1. This command is for use with spooled unit record devices and 
virtual consoles only. 

2. Any I/O operation to the specified device, in progress at the time 
the command is issued, is completed. On the next Start I/O (SIO) 
instruction, the not ready condition is in effect. 



Response 



None. 
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PEiviiege Class: G 

Use the ORDER command to place your closed spool files in a specific 
order by device type. The format of the ORDER command is: 

ORDer | ^Reader ) /CLass c1 CLass c2...) 4 
I < Printer > Ispoolidl spoolid2...J 
I (punch j 

*A combination of CLASS and spoolid specifications may be entered. 



where : 

READER specifies that the reader spool files are to be placed in 
RDR order. 

PRINTER specifies that the printer spool files are to be placed in 
PRT order. 

PUNCH specifies that the punch spool files are to be placed in 
PCH order. 

CLASS C1 CLASS c2. .. 

are the class (es) to be rearranged and the sequence in which 
they are to be processed. CLASS is a required reserved word 
and d, c2,... are one-character alphameric fields (with 
values from A to Z and from to 9) that represent spooling 
classes. 

spoolidl spoolid2... 

are the spoolids of the files to be rearranged and the 
sequence in which they are to be processed. 



Usac[e Notes 

1. You may order only your own files. 

2. Use the QUERY command to determine spool file attributes such as 
class and spoolid for files you want to rearrange. 

3. A combination of class and spoolid specifications can be used to 
rearrange files. For example: 

ORDER PRINTER CLASS A 1963 CLASS C 

specifies that printer files are processed in the following order: 
all class A files, the file with spoolid 1963, all class C files, 
followed by any other printer spool files not specified in the 
ORDER command line. 
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H. When duplicate spoolids are present, the ORDER command resequences 
only the first duplicate spool file found. 

5. The order of your spool files may change without warning between 
terminal sessions if the system was restarted with a checkpoint 
restart. 



Response 

(nnnn) FILES ORDERED 
\ NO / 

indicates the number of files that were placed in order. It is not 
displayed if you issued the CP SET IMSG OFF command. 
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PURGE 



Privilege Class : G 



Use the PURGE command to remove your own closed spool files from the 
system before they are printed or punched bj the spooling devices, or 
before they are read by a user. The format of the PURGE command is: 



PURge 

Reader |CLass d CLass c2.. 

Printer |spoolid1 spoolid2 

PUnch |ALL 

ALL »- 

*A combination of CLASS and spoolid specifications may be entered 



i 



where : 



READER 
RDR 



purges reader files. 



PRINTER 
PRT 



purges printer spool files. 



PUNCH 
PCH 



purges punch spool files 



ALL 



purges all reader, printer, and punch spool files. When ALL 
is specified instead of a device type, all other operands are 
ignored. 



CLASS C1 CLASS c2. . . 

are the class (es) of files to be purged. CLASS is a reguired 
reserved word and d, c2,... are one-character alphameric 
fields (with values from A to Z and to 9) that represent 
spooling classes. 

spoolidl spoolid2... 

are the spoolids of specific files to be purged. 



ALL 



purges all files of the specified type (reader, printer, or 
punch) . 



Usage Notes 



1. Any closed spool file, owned by you, may be purged, regardless of 
its status, as long as it has not been selected for processing. 

2. Purging can be done using a combination of CLASS and spoolid 
specifications. For example: 

PURGE PRINTER CLASS A 1932 CLASS D 6 19 

specifies that all class A and class D printer files and printer 
files with spoolids of 1932 and 619 are to be purged. 
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A file that has been spooled to another user's reader cannot be 
purged unless it is first reclaimed via the TRANSFER command. 



Response 

fnnnn] FILES PURGED 
I HO / 

indicates the number of files purged. It is not displayed if you 
issued the CP SET IMSG OFF command. 
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QUERY 

Pfillieae Class: G and all classes except class Any 

Use the class G QUERY command to determine your system status and 
machine configuration by requesting: 

The time you have used during a terminal session. 

The number of closed input and output spool files associated with 
your virtual machine. 

The current settings of the SET command functions. 

The current settings of the TERMINAL command functions. 

The status of all the devices on your virtual machine. 

The channel operating mode of your virtual machine, whether 
block-multiplexer or selector. 

A listing of all users who are linked to a given virtual address, 
together with their device addresses and access modes. 

Identification and attributes associated with your virtual printer, 
punch, and reader spool files. 

There are other operands you can use with the QUERY coamand if you 
have the privilege class required to use them. These are described in 
the VM/370: O£eratorj.s Guide. Also, if you are a CMS user, you can use 
the CMS QUERY command to query the status of your CMS virtual machine. 

Note: Use the NETWORK QUERY command to query 3704/3705 resources and 
remote 3270 devices attached to a 2701 or 2703 or a 3701/3705 in EP or 
PEP mode. 

For ease of use, the QUERY command and operands described in this 
section have been separated into the operands available for general 
users (class G) and those available to all users except class Any. 



Section 5. Format of CP Commands 93 



QUERY 



QUERY COMMAND FOR CLASS G USERS 



The format of the Class G QUERY command is 



Query 



Time 

Set 

TERMinal 

Files [CLass c ] 



[Virtual] 



Links 

Reader 

Printer 

PUnch 



PF[nn] 



CHANnels 

GRAF 

CONsole 

DAsd 

TApes 

LINES 

UR 

STORage 

ALL 

vaddr 

vaddr 

r t 

|spoolid| 
I ALL | 
| CLass c| 

L J 



wh er e : 

TIME 

SET 



displays the current time, time zone, weekday, date„ connect 
and CPU time for the current terminal session. 

displays the status of the SET command functions. 



TERMINAL displays the current options in effect for your virtual 
console environment. 

FILES [CLASS c] 

displays the number of spooled input and output files for your 
virtual machine. Files currently being processed are not 
included in the totals. If CLASS is specified, the number of 
spooled input and output files of the class specified is 
displayed. 

VIRTUAL displays the status of all virtual devices. 

CHANNELS displays the channel mode of operation for the 
virtual machine. 

GRAF displays the status of all your virtual display 
devices that are locally attached. 

CONSOLE displays the status of your virtual consoles. 

DASD displays the status of all your virtual direct 
access storage devices. 
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TAPES displays the status of all your virtual magnetic 
tape devices. 

LINES displays the status of all your virtual 
communication lines. 

UR displays the status of all your unit record 
devices. 

STORAGE displays the size of your virtual storage. 

ALL displays the status of all your virtual devices. 

vaddr displays the status of the virtual device at address 
vaddr . 



LINKS vaddr 

displays the userid, device address, and access mode at the 
terminal for all users linked to the specified virtual address 
(vaddr) . 



READER 

RDR 

PRINTER 

PRT 

PUNCH 

PCH 



displays the following information, pertaining to your closed 
virtual reader, virtual printer, and virtual punch spool files: 

Userid (of user who created the file) 
Spool file identification (spoolid) 
Class and originating device type 
Number of logical records in the file 

Number of copies specified for the file (has no effect for 
reader files) 
• File hold status 

One line of information is displayed for each spool file. 



READER ) 

PRINTER > spoolid 
PUNCH ) 



displays additional information for one spool file. The 
spoolid operand must follow the READER, PRINTER, or PUNCH 
operand. In addition to the information normally displayed for 
reader, printer, or punch files, the following is also 
displayed: 

• Date and time the file was created 

• Filename and filetype of file (if any) ; if your file was 
assigned a dsname and you later issue QUERY, only the first 
20 characters of the 24-character field are displayed. 

• Distribution code of the file (printer and punch files 
only) 



Only one line of data is displayed (that data 
the spool file specified by spoolid) . 



pertaining to 



READER 

PRINTER 

PUNCH 



ALL 

displays additional information for spool files. The ALL 
operand must follow the READER, PRINTER, or PUNCH operand. In 
addition to the information normally displayed for the reader, 
printer, or punch files, the following is also displayed: 
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• Date and tine the file was created 

• Filename and filetype of file (if any) ; if your file was 
assigned a dsname and you later issue QUERY, only the first 
20 characters of the 24-character field are displayed. 

• Distribution code of the file (PRINTER and PUNCH files 
only) 

One line of information is displayed for each spool file of 
the type specified. 

(READER ) 

< PRIHTER> CLASS C 

(punch J 

displays the basic information for all spool files of the 
class specified by c. This operand must follow the READER, 
PRINTER, or PUNCH operands. One line of information is 
displayed for each spool file of the specified class. 

PF[nn] displays the 3270 Program Function key number specified, along 
with its associated command lines. If nn is not specified, all 
12 program function keys and their associated data lines are 
displayed. The value, nn, is a number from 1 (or 01) to 12. 
See the CP SET command for an explanation of how to define and 
use program function keys. 
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QUERY Command Responses for Class G Users 

This section describes the messages that CP issues in response to your 
specific QUERY operands. 



QUERY TIME 

TIME IS hh:mm:ss zone weekday mm/dd/yy 

The current real clock time in hours: minutes: seconds, the time zone 
(for example, EST) , the day of the week and the calendar date 
(month/day/year) are displayed. 

CONNECT= hh:mm:ss VIRTCPU= mmm:ss.hs TOTCPU= mmm:ss.hs 

The time spent in the current terminal session is displayed. 

where : 

CONNECT= hh:mm:ss is the actual clock time spent in the current 

terminal session in hours :minutes:seconds. 

VIRTCPU= mmm:ss.hs is the virtual CPU time used in the current 

terminal session in minutes:seconds. hundredths 
of seconds. 

TOTCPU= mmm:ss.hs is the total CPU time (virtual and overhead) 

used in the current terminal session in 
minutes: seconds. hundredths of seconds. 



QUERY SET 



MSG 




/ON ) /ON ) )CODE( /ON ) /ON \ 
(OFF/, WNG (OFF/, EMSG ( TEXT ), ACNT\OFFJ, RUN \ OFF j 



LINEDIT \ OFF/, TIMER < OFF >, ISAM (OFF/, ECMODE (OFF 

( real) 



/ON ) 



ON 



/SVC n 

| < \NOSVC/> / 0N I 

| ASSIST (off ), PAGEX\OFF/ 



IMSG 



(ON ) 
I OFF/ 



The settings of all functions controlled by the SET command and the 
VM/370 directory ISAM and ECMODE options are displayed. Refer to 
the discussion of the SET command for explanations of the 
functions. 



Section 5. Format of CP Commands 97 



QUERY 

QUERY TERMINAL 



LI 



NEND (OFF/, LINEDEL { OFF/, CHARDEL {oFFj, ESCAPE \ OFF j 

/ON ) / ON ) /ON ) (CP ( 

(OFF/, APL (OFF/, ATTN \0FFJ, MODE \ VM / 



LINESIZE nnn, MASK 

The settings of all functions that are controlled by the TERMINAL 
command are displayed. Refer to the discussion of the TERMINAL 
command for explanations of the functions. If LINEDIT is turned 
off, the logical editing symbols displayed are those that were in 
effect before line editing was turned off,. 



QJJERY FILES [.CLASS c_] 

FILES: / nnn "1 RDR, / nnn ) PRT, / nnn ) PUN 
1 NO j \ NO / \ NO / 

The total number of spool files in your system is displayed. If you 
specify the CLASS option with QUERY FILES, only the totals for the 
class you specify are indicated rather than for all classes on your 
system. 



QJEjy VIRTUAL CHANNELS 



CHANNELS= 



( SEL \ 
\ BMX j 



The operating mode of the virtual machine channels is displayed. 
This response applies to all of the virtual machine channels except 
channel 0, which is always a byte multiplexer channel, and any 
channels with virtual or real channel-to-channel adapters, which 
are always selector channels. 



QUERY VIRTUAL GRAF 



lr / ON ] 
\ NOT 



GRAF vaddr j ON DEV raddr 
READY 



The status of all locally attached virtual display devices defined 
to your virtual machine is displayed. 

where : 

vaddr is the virtual address to which the device is attached. 

raddr is the real address of the device. 

NOT READY shows the status of a virtual display device that has not 
been attached via the DIAL command. 
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QUERY VIRTUAL CONSOLE 



CONS vaddr ON 
vaddr C 



/GRAF\ ( TERM W STOP ) 
\ LINE J raddr \ NOTERM J \ START j 

/ CONT W HOLD) ( READY) 

L c \NOCONT / I NOHOLDJ COPY nn\NOTREADYJ 



(TO \ 
Ir (FORJ useri 



vaddr (FORJ userid DIST distcode 

For virtual machine consoles, a three- line response is displayed. 
The first line shows the console status and options and the next 
two lines show the virtual console spooling status. 

where : 

vaddr is the virtual address of the virtual machine console. 

raddr is the real address of the terminal associated with the 
virtual console. 

c is the spooling class of the console. 

nn is the number of copies spooled. 

userid is the user identification. 

distcode is the distribution code. 

The other fields indicate the setting of the respective options in 
the SPOOL command. 

The default settings for a virtual console are: 

CONS vaddr ON DEV raddr TERM STOP 

vaddr CL T NOCONT NOHOLD COPY 01 READY 
vaddr FOR userid DIST distcode 



QUERY. VIRTUAL DASD 



(R/W) 

\ R/O j nnn 



DASD vaddr type volser \ R/O j nnn CYL 

The status of each virtual disk defined for your system is 
displayed. 

where : 

vaddr is the virtual address to which the DASD device is 
attached. 
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type is one of the following device types: 

I 231T (2311 at top of 2314) 

I 231B (2311 at bottom of 2314) 

2311 

2305 

2314 

3330 

3340 
I 3350 

volser is the volume serial number of the system disk on which 
this virtual disk resides. 

R/W indicates the read/write status of the disk. 
R/0 

nnn is the number of cylinders on the virtual disk. 



QUERY VIRTUAL TAPES 

TAPE vaddr ON DEV raddr 

The status of each tape defined for your system is displayed. 
w her e : 

vaddr is the virtual address to which the tape is attached, 
raddr is the real address of the tape. 

QUERY VIRTUAL LINES 

LINE vaddr ON DEV raddr 

The status of all communication lines defined in your virtual 
machine is displayed. 

where : 

vaddr is the virtual address to which the line is attached. 

raddr is the real address of the line. 



/ ENABLED ) 
\ DISABLED J 



LINE vaddr (DISABLED 

The status of virtual communication lines at virtual address vaddr 
is displayed. 



QUERY VIRTUAL UR 

/ CONT) / HOLD)/ EOF)/ READY) 
RDR vaddr CL c \NOCONTJ \N0H0LD J \ NOEOF / \ NOTREADY / 
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The status of all the virtual readers attached to your virtual 
machine is displayed. 

where : 

vaddr is the virtual device address of the virtual reader. 

c is the spool file class which the device services. A 
class of * indicates the device serves all classes of 
spool files for input. 

The other fields indicate the setting of the respective options in 
the SPOOL command. 

The default settings for a reader are: 

RDR vaddr CL * NOCONT NOHOLD READY EOF 

|PRT\ ( CONT W HOLD) ( READY) 

(PUN) vaddr CL c ( NOCONT J (NOHOLD/ COPY nn ( NOTREADY / 

(TO ) 
vaddr ( FOR ) userid DIST dxstcode 

The status of all the virtual printers and punches attached to your 
virtual machine is displayed. 

where : 

vaddr is the virtual device address of the virtual printer or 
punch. 

c is the output class assigned to spool files produced from 
the device. 

nn is the number of copies of each output file to be 
produced. 

TO userid indicates that the output from the device, when closed, 
becomes a reader input spool file for the indicated 
userid. 

FOR userid 

indicates the userid identification (spool file owner) 
assigned to spool files produced from the device. 

distcode is the distribution code assigned to each spool file 
produced from the device. 

Note: The distcode in this case indicates the FOR userid; however, 
the distcode produced on the output files when the file is closed 
is the distcode assigned to the FOR userid as specified in the 
VM/370 directory. 

The other fields indicate the setting of the respective options in 
the SPOOL command. 



The default settings are 

/ PRT\ 
I PUN J 



vaddr CL A NOCONT NOHOLD COPY READY 01 
vaddr FOB userid DIST distcode 
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where : 

user-id and distcode are assigned for the virtual machine. 

QJII1X VIRTUAL STORAGE 

STORAGE = nnnnnK 

The size of the virtual machine in multiples of 1024 bytes is 
displayed. 



PJURY VIRTUAL ALL 

Has the same effect as if all the following commands were issued 

QUERY VIRTUAL STORAGE 

QUERY VIRTUAL LINES 

QUERY VIRTUAL TAPE 

QUERY VIRTUAL UR 

QUERY VIRTUAL DASD 

QUERY VIRTUAL GRAF 

QUERY VIRTUAL CONSOLE 

QUERY VIRTUAL CHANNELS 



2P.ERY VIRTUAL vaddr 

The response is in the same form as QUERY VIRTUAL DASD, TAPES, LINES, or 
UR, depending on virtual device type. 



Q.U.EJI LINKS vaddr 



userid vaddr (R/O), 
IR/HJ 



A list of users who are currently linked to the device at virtual 
address vaddr is displayed. 

where : 

userid is the identification of the user who originated the 
link. 

vaddr is the virtual address by which the user (userid) refers 
to the device. 

R/0 is the type of access the user (userid) has to the 
H/W device. 
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QUERY 
£UERY READER, QUERY PRINTER, QUE RY PUNCH 



r t 

ORIGINID FILE CLASS RECDS CPY HOLD |DATE TIME NAME TYPE DIST | 

userid spoolid c typ norecs nn stat | mm/dd hh:mm:ss fn ft distcodel 

L J 



where : 

userid is the user who originally created the file. 

spoolid is a unique, system-assigned number which is used by VM/370 to 
identify the file. 

c is the spool file class. 

typ is the originating device type (PRT, PUN, CON, or RDR) . 

norecs is the number of logical records contained in the file. 

nn is the number of copies assigned to the file (it has no effect 
for virtual reader files) . 

stat is the file hold status: NONE (no hold) , USER (user hold) , SYS 
(system hold) , or USYS (system and user hold) . 

mm/dd is the date the file was created in month/day. 

hh:mm:ss is the time the file was opened for creation in 
hours: minutes: seconds. 

f n is the filename assigned to the file (if any) . If the file 
has a 24-character data set name (dsname) , only 20 characters 
are displayed. These characters extend from the ••name" field 
through the "type" field. 

ft is the filetype assigned to the file (if any) . 

distcode is the distribution code assigned to the file. 

When you issue QUERY READER, QUERY PRINTER, or QUERY PUNCH commands, 
CP responds by listing (in the form described) all the files associated 
with your virtual reader, printer, or punch. 

The information listing DATE, TIME, NAME, TYPE, and DIST (date of 
file creation, time of file creation, name of file, filetype of file, 
and file distribution code) is displayed only when you specify the ALL 
or spoolid operands. 

QUERY PFnn 



:mmed) 

(ELAYj 



I 11 
PFnn (DELAY/ pfdatal... 



The program function defined for a program function key is 
displayed. If there is no function defined for the program 
function key, the following message is issued: 

PFnn UNDEFINED 
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QUERY COMMAND FOR ALL CLASSES OF USERS (EXCEPT CLASS ANY) 

This form of the QUERY command is for all classes of users except those 
in the Any category. Use this form of the QUERY command to: 

• Display the log messages. 

• List all the users that are logged on. 

• Display the number of users that are logged on or dialed to VM/370. 

The format for this QUERY command is: 

| Query | ( LOGmsg 

I J / Names 

I | \ Users [userid] 

I I ' userid 

L , 



where : 

LOGMSG displays the log messages of the day. 

NAMES displays a list of all the users logged on and the real 

address of the line to which each is connected. If a user 

is disconnected, DSC is printed instead of the line 
address. 

USERS displays the number of logged on users and the number of 
users logically connected to other virtual machines. 

USERS userid displays the user identification and the terminal device 

userid address of the specified user if he is logged on. If the 

user is not logged on, a message to this effect is issued. 

Use the QUERY USERS userid format if the userid is the same 

as an operand of the QUERY command (for example, TAPES) . 

Note: It is possible for the number of users logged on as indicated by 
the "NAMES" operand to differ from the number of users indicated by the 
"USERS" operand if the QUERY command is executed while users are in the 
process of logging on or logging off the system. 



fiUIH Command Resp_onses for All Classes of Users (Except Class Any) 
QUERY LOGMSG 

* logmsg text line 1 

* logmsg text line n 

All lines (both those with an asterisk and without) in the log 
message file are displayed. 
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QUERY NAMES 

userid - fDSC |, ... 

< raddr > 
(resid) 

userid - ("DSC ), ... 

< raddr } 
(resid ) 

A list of all logged-on users is displayed; if the user is 
currently connected, the real address (raddr) , or the resource 
identification of a 3704/3705 line (resid) to which he is connected 
is displayed; if he is not connected to the system^ DSC is 
displayed. 

QUERY USERS 

nnn USERS, mmm DIALED 

The number of users logged on and dialed to VM/370 is displayed. 

where : 

nnn is the total number of logged— on users. 

mmm is the total number of users attached via DIAL to virtual 
machines. 

Note: DIALED means the line is not available to CP because it is 
logically attached to a multiple-access virtual machine and is a 
part of that user's virtual machine operation. 

QUERY userid or QUERY USERS userid 

userid - (raddr) 
I resid J 

The real address (raddr) or the resource identification of a 
3704/3705 line (resid) to which the specified user is connected is 
displayed. 
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READY 

Privilege Class: G 

Use the READY command to set a device-end interruption pending for a 
specified virtual device. The format of the READY command is: 



| READY | vaddr | 



where : 

vaddr is a virtual device address (cuu) 



Usacje Notes 

1. The status of the virtual machine is unchanged. 

2. other than having a device-end interruption pending, the virtual 
device is unchanged. 



Responses 



None. 
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REQUEST 

PtixiiSS® Class: G 

Use the REQUEST command to make an attention interruption pending at 
your virtual console. The format of the REQUEST command is: 



| REQuest | I 



Usage Note 

The REQUEST command performs the same functions as ATTN and the two 
commands can be used interchangeably. 



Responses 



None. 
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RESET 

Privilege Class: G 

Use the RESET command to clear all pending interruptions from the 
specified virtual device. The format of the RESET command is: 



| RESET | vaddr 

L , ._ 



where : 

vaddr is a virtual device address (cuu) of the device to be reset. 

Usage Note 

In addition to clearing all pending interruptions, all error conditions 
occurring as a result of unit checks and virtual sense bytes are reset. 

lesjgojases 

DEVICE RESET 

is the response you receive upon the the successful completion of 
the command. 
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REWIND 

PEixil^cje Class: G 

Use the REWIND command to rewind (but not unload) a real tape unit 
attached to your virtual machine at a specific virtual device address. 
The format of the REWIND command is: 



| REWind | vaddr I 



where : 

vaddr is the virtual device address (cuu) of the tape unit to be 
rewound. 



Usage Note 

The REWIND command accomplishes the manual operation of rewinding and 
making the tape ready at the tape unit. 



Responses 

REWIND COMPLETE 

is the response you receive upon the the successful initiation of 
the command. 

REWIND NOT PERFORNED 

is the response you receive if the real tape unit is not ready. 
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SET 



EEiv±i<i3§ Class: G 

Use the SET command to control various functions within your virtual 
system. The format of the SET command is: 



SET 



ACNT 


Jon \ 

(OFF J 


MSG 


WNG 




IMSG 




RUN 




LINEDit 




ECmode 




ISAM 




NOTRans 




PAGEX 




EMSG 


(ON 




;off 




)CODE 

(text, 




TIMER 


(ON 
< OFF 
( REAL 







\ 






\ 



r i r t 

ASsist \ I ON | | SVC | 

| | |NOSVC| 

L J L J 

OFF 



PFnn |IMMed | [ pf data 1#pfdata2# . 

I SIMyed | 

L J 

PFnn [ TAB nl n2 ... ] 
PFnn COPY [resid] 
PFnn COPY [cuu] 



.pf datan ] 



where: 
ACNT 



| ON ) 
(OFF J 



msg Jon \ 
\ off/ 



controls whether accounting information is displayed at 
the terminal or not (ON and OFF, respectively) when the 
operator issues the CP ACNT command. When you log on 
VM/370, ACNT is set on. 

controls whether messages sent by the MSG command from 
other users are to be received at the terminal. If ON is 
specified, the messages are displayed. If OFF is 
specified, no messages are received. In addition to 
controlling messages generated by the MSG command, 
spooling messages generated by users sending punch. 
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roN ) 

(OFF/ 



SET 

printer or reader files to another virtual machine are 
also suppressed if OFF is specified. When you log on 
VM/370 r MSG is set on. 

WNG /ON ) controls whether warning messages are displayed at the 
terminal. If ON is specified, all warning messages sent 
via the CP WARNING command from the system operator are 
received at the terminal. If OFF is specified, no 
warning messages are received. When you log on VM/370, 
WNG is set on. 



IMSG /ON 1 controls whether certain informational responses issued 
(OFF) by the CP CHANGE, DEFINE, DETACH, ORDER, PURGE, and 
TRANSFER commands are displayed at the terminal or not. 
The descriptions of these CP commands tell which 
responses are affected. If ON is specified the 
informational responses are displayed. If OFF is 
specified, they are not. The SET IMSG ON or OFF command 
line has no effect on the handling of error messages set 
by the SET EMSG command. When you log on VM/370, IMSG is 
set on. 



RUN (ON ) controls whether the virtual machine stops when the 
(OFF/ Attention key is pressed. ON allows you to activate the 
Attention key (causing a read of a CP command) without 
stopping your virtual machine. When the CP command is 
entered, it is immediately executed and the virtual 
machine resumes execution. OFF places the virtual 
machine in the normal CP environment, so that when the 
Attention key is pressed, the virtual machine stops. 
When you log on VM/370, RUN is set off. 

LINEDIT ( ON ) controls the line editing functions. ON specifies that 
( OFF/ the line editing functions and the symbols of the VM/370 
system are to be used to edit virtual CPU console input 
reguests. This establishes line editing features in 
systems that do not normally provide them. OFF specifies 
that no character or line editing is to be used for the 
virtual machine operating system. When you log on 
VM/370, LINEDIT is set on. 



(ON ) 

(off/ 



ECMODE /ON I controls whether the virtual machine operating 
system may use System/370 extended control mode and 
control registers 1 through 15. Control register zero may 
be used with ECMODE either ON or OFF. When you log on 
VM/370, ECMODE is set according to the user's directory 
option; ON if ECMODE was specified and OFF if not. 

Note: Execution of the SET ECMODE {ON|OFF} command always 
causes a virtual system reset. 

ISAM ( ON \ controls whether additional checking is performed 

(OFF/ on virtual I/O reguests to DASD in order to support the 

OS Indexed Seguential Access Method (ISAM) . When you log 

on VM/370, ISAM is set according to the user's directory 

options; ON if ISAM was specified and OFF if not. 
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NOTRANS 



(ON ) 
(OFF/ 



controls CCW translation for CP. NOTRANS can be 
specified only by a virtual machine that occupies the 
virtual=real space. It causes all virtual I/O from the 
issuing virtual machine to bypass the CP CCH translation 
except under the following conditions: 

SIO tracing active 
1st CCH not in the V=R region 
I/O operation is a sense command 
I/O device is a dial— up terminal 
I/O is for a non-dedicated device 
Pending device status 

Any of the above conditions will force CCW translation. 

To be in effect in the virtual=real environment, SET 
NOTRANS OH must be issued after the virtual=real machine 
is loaded via the IPL command. (IPL sets the NOTRANS 
option to an OFF condition.) 



PAGEX /ON ) 
(OFF/ 



controls the pseudo page fault port 
VM/VS Handshaking feature. PAGEX ON or OFF 
issued for an 0S/VS1 virtual machine that 
Handshaking feature active. It can only be 
a virtual machine that has the extended 
(ECMODE) option. PAGEX ON sets on the pse 
portion of handshaking; PAGEX OFF sets it 
log on to VM/370, PAGEX is set OFF. Also, 
IPL VS1 in your virtual machine PAGEX is se 
want to use the pseudo page fault handli 
handshaking you must issue SET PAGEX ON 
VS1. 



ion of the 

should only be 

has the VM/VS 

specified for 

control mode 

udo page fault 

off. When you 

each time you 

t off. If you 

ng portion of 

after you IPL 



EMSG 




controls error message handling. ON specifies that both 
the error code and text are displayed at the terminal. 
TEXT specifies that only text is displayed. CODE 
specifies that only the error code is to be displayed. 
OFF specifies that no error message is to be displayed. 
When you log on VM/370, EMSG is set to TEXT. 

If the console is being spooled, the OFF setting is 
ignored for the spooled output and the full error message 
appears in the spooled output. The other three settings 
result in spooled output that matches the console 
printout. 

Note: CMS recognizes EMSG settings for all error (E) , 
information (I) , and warning (W) messages, but ignores 
the EMSG setting and displays the complete message (error 
code and text) for all response (R) , severe error (s) , 
and terminal (T) messages. 



TIMER 



ON j 


control 


OFF > 


virtual 


real) 


is runn 




to be u 




to be u 




virtual 




in your 




you leg 



s the virtual timer. ON specifies that the 

timer is to be updated only when the virtual CPU 

ing. OFF specifies that the virtual timer is not 

pdated. REAL specifies that the virtual timer is 

pdated during virtual CPU run time and also during 

wait time. If the REALTIMER option is specified 

VM/370 directory entry, TIMER is set to REAL when 

on; otherwise it is set to ON when you log on. 
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ASSIST 



r i r n 

|0N | |SVC | 

| | |NOSVC| 

L J L J 



OFF 



controls the availability of the virtual machine assist 
feature for your virtual machine. The assist feature is 
available to your virtual machine when you log on if (1) 
the real CPU has the feature installed and (2) the system 
operator has not turned the feature off. The SVC handling 
portion of the assist feature is invoked when you log on 
unless your VM/370 directory entry has the SVCOFF option. 
Issue the QUERY SET command line to see if the assist 
feature is activated and whether the assist feature or 
VM/370 is handling SVC interruptions. All SVC 76 
requests are passed to CP for handling, regardless of the 
SVC and NOSVC operands. If you issue the SET ASSIST 
command line and specify SVC or NOSVC while the virtual 
machine assist feature is turned off, the appropriate 
bits are set. Later, if the feature is turned on again, 
the operand you specified while it was off becomes 
effective. ON sets the assist feature on for the virtual 
machine; OFF turns it off. SVC specifies that the assist 
feature handles all SVC interruptions except SVC 76 for 
the virtual machine; NOSVC means VM/370 handles all the 
SVC interruptions. See the VM/370: System Programmer's 
Guide for information on how to use the assist feature. 



PFnn |IMMED | [pfdata1#pfdata2#. . .pfdatan ] 
I DELAYED | 



nn 



IMMED 



DELAYED 



defines a program function for a program function key on 
a 3277 Display Station and indicates when that function 
is to be executed. See the VM/370: Terminal User's Guide 
for a description of how to use the 3277 program function 
keys. 

is a number from 1 (or 01) to 12 that corresponds to 
a key on a 3277. The program function is a 
programming capability you create by defining a 
series of VM/370 commands or data you want executed. 
This series of commands executes when you press the 
appropriate program function key. 

specifes that the program function is executed 
immediately after you press the program function 
key. 

specifies that execution of the program function is 
delayed for a display terminal. When the program 
function is entered, it is displayed in the input 
area and not executed until you press the Enter key. 
DELAYED is the default value for display terminals. 



pfdata1#pfdata2#. . .pfdatan 

defines the VM/370 command or data lines that 
constitute the program function. If more than one 
command line is to be entered, the pound sign (#) 
must separate the lines. If you use the pound sign 
(#) to separate commands that you want executed with 
the designated PF key, you must precede the command 
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line with #CP, turn line editing off, or precede 
each pound sign with the logical escape character 
('•) . For further explanation, see the "Usage Notes" 
section that follows. If no command lines are 
entered, PFnn is a null command. Program functions 
cannot be embedded within one another. 

PFnn TAB n1 n2 ... 

specifies a program function number to be associated with 
tab settings on a terminal. The number of the PF key, nn 
can be a value from 1 (or 01) to 12. For examples of how 
this feature is used, see the VM/370: CMS User^_s Guide. 

TAB is a keyword identifying the tab function. The tab 

settings (n1 n2 ...) may be entered in any order. 

PFnn COPY [resid] 

specifies that the program function key, numbered nn, 
performs a COPY function for a remote 3270 terminal, nn 
must be a value from 1 (or 01) to 12. The COPY function 
produces a printed output of the entire screen display at 
the time the PF key is actuated. The output is printed on 
an IBM 3284, 3286 or 3288 printer connected to the same 
control unit as your display terminal. 

resid may be specified if more than one printer is 

connected to the same control unit as your display 
terminal. It is a three-character hexadecimal 
resource identification number assigned to a 
specific printer. If resid is entered, the printed 
copy is directed to a specific printer; if not, the 
copy is printed on the printer with the lowest resid 
number. The resid numbers of the printers available 
to your display terminal can be obtained from your 
system operator. If only one printer is available, 
as with the 3275 Display Station, resid need not be 
specified. 

PFnn COPY [cuu] 

specifies that the program function key, numbered nn, 

performs a COPY function for a local 3270 terminal. nn 

must b€j a value from 1 (or 01) to 12. When the PF key is 

actuated, the COPY function produces a printed output of 
the entire local screen display except for the status 
field which is replaced with blanks. 

cuu is the real hardware address of the 3284, 3286, or 

3288 printer, and may specify a printer that is on a 
different control unit than the one to which your 
3270 is attached. If you do not specify cuu, the 
printer with the lowest cuu that is available on the 
same control unit as your 3270 will be selected. 

Note: For both remote and local COPY functions: 

You will receive a NOT ACCEPTED message, displayed in the screen 
status field of your 3270, if any of the the following situations 
occur : 

• The printer is already busy, or all printers are busy. 

• The printer is turned off. 

• The printer is out of paper or is in any other intervention 
reguired condition. 

• The designated device is not a 328X type printer. 

• The SET PFnn COPY command is invalid. 
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You may include your own identification on the printed output by 
entering the data into the user input area of the screen before you 
press the PF key. The identification appears on the last two lines 
of the printed copy. 



U§§3® Notes 

1. Both SET PFnn TAB and SET PFnn COPY are immediate commands: their 
function is executed immediately upon pressing the appropriate 
program function key. If you insert the keyword DELAYED after the 
PFnn operand, the command will be accepted, however, the program 
function will still be executed immediately. 

2. If you use the SET PFnn command to set up a series of concatenated 
commands, you should be aware of the following situation: 

If you enter one of the following commands while in CMS mode: 

SET PF02 IMMED Q EDRtQ PRT#Q PUN 
— or — 

CP SET PF02 IMMED Q RDR#Q PRT#Q PUN 
and then press the Enter key: 

1. The Enter key causes immediate execution, 

2. Only the Q PRT and Q PUN commands execute, and 

3. Q PRT and Q PUN are stripped from the PF02 key 
assignment leaving Q RDR, which was not executed. 

The following examples demonstrate two methods for avoiding the 
problem. 



Example J 

Enter one of the following commands while in CMS mode: 
#CP SET PF02 IMMED Q RDR#Q PRT#Q PUN 

— or — 

CP SET PF02 IMMED Q RDR"#Q PRT"#Q PUN 

— or — 

SET PF02 IMMED Q RDR"#Q PRT"#Q PUN 

Now press the Enter key. 

CP assigns the three QUERY commands as functions of the PF02 key, 
Pressing the PF02 key executes the three QUERY commands. 
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Example 2 

Enter the following command while in CHS mode: 

SET LINEDIT OFF 
and press the Enter key. 
Then enter: 

SET PF02 IMMED Q RDB#Q PRT#Q PUN 
— or — 

CP SET PF02 IMMED Q RDR#Q PRT#Q PUN 
and press the Enter key. 

CP assigns the three QUERY commands as functions of the PF02 key, 

Then enter: 

SET LINEDIT ON 
and press the Enter key. 

Pressing the PF02 key executes the three QUERY commands. 

Responses 
None 
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SLEEP 



Privilege Class: Any 



Use the SLEEP command to place the virtual machine in a dormant state 
but allow messages to be displayed. You can specify a sleep interval in 
the command line and the virtual machine is awakened automatically when 
the specified interval has elapsed. The format of the SLEEP command is: 



SLeep 




where: 



r r -i 

I I SEC | 

|nn |MIN| 

I |HRs| 

L L J 



indicates the number of seconds, minutes, or hours, measured 
by the time— of-day clock, that the virtual machine is to 
remain dormant. The value nn can be any decimal number from 
00 through 99. If you specify no time unit, the value of nn 
is taken to be in minutes. 



Usage Notes 



During the dormant period, the virtual machine 
connection time is still being counted. 



does not run but 



The terminal can be awakened at any time by signaling attention. 



If no interval is specified, the virtual machine 
until awakened by signaling attention. 



remains dormant 



If you issue the SLEEP command from a CP read or from a VM read 
using the CP "escape" function (#CP SLEEP) , the end of the time 
interval or signaling attention returns you to the CP environment. 

If you issue the SLEEP command while in virtual machine mode (for 
example, CMS execution of the command line CP SLEEP) , the end of 
the time interval or signaling attention returns your terminal to 
virtual machine mode without entering the CP environment. 

The SLEEP command, with the time interval, is a convenient way to 
delay or schedule the execution of certain jobs that could be run 
more efficiently at a later time; for example, second shift. 



Responses 



None 
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SPOOL 



f.£±lii63§ Class: G 



Use the SPOOL command to modify the spooling control options in effect 
for a given virtual spooling device or for a group of devices. The 
SPOOL command can also start or stop the spooling of virtual console 
input and output. You can direct a file to a remote location by using 
the SPOOL command in conjunction with the TAG command. This latter 
function is discussed below in the section "Transmitting Files to Remote 
Locations. " The format of the SPOOL command is: 



SPool 



(Reader ) 
(vaddr J 



Printer 

PUnch 

vaddr 



r 

ICLass 



{*}! 



r 

ICONt 
I MOCont 



HOld | | EOF | 
NOHold| |NOEof| 



rr-ir mr ir i 

||To Muserid | | |H01d | |CONt | U 

||For|| * | | |NOHold| |NOCont |[CLass c] [COpy nn ] 

| >- J | SYSTEM | | «- J l j 

I l J I 



OFF 



r n 
| CLOSE | 
IPURGE | 

L J 



(CONsole) \ | STArt| jHOld | | CONt | |TErm | | T To ]|userid|| 
I vaddr J HSTOp | |NOHold| |NOCont| | NOTErm | |[ For J | * || 



[CLass c] [COpy nn ] 



r t I 

|CLOSE| |OFF 
| PURGE | >- 

L J 



|SYSTEM| 

L J 



J At least one of the options within braces must be selected; however, 
more than one may be specified, and they may be entered in any order. 



where : 

READER modifies the options for all reader spool files. 
RDR 



PRINTER modifies the options for all printer spool files, 
PRT 



PUNCH 
PCH 



modifies the options for all punch spool devices, 
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CONSOLE modifies the options for the virtual console spool file and/or 
initiates or stops the spooling of virtual console input and 
output, including CP input/output. 

vaddr is the virtual device address (cuu) of the virtual unit record 
device or console whose options are to be modified. 

CLASS (c) specifies the spool class of the device. c is a 
(*/ one-character alphameric field whose values can be A through 
Z, or 1 through 9. 

Unless your virtual reader class is asterisk (*) , you must 
ensure that any files to be read by your virtual reader are of 
the same spool class as your virtual reader. The * is the 
universal class; if your virtual reader is class *, it can 
read any file, regardless of class. 

CONT ignores intermediate end-of-file indications or CLOSE 
reguests. For virtual readers, reading is continuous, with 
all end-of-file indicators ignored until all files spooled to 
the virtual machine are read in. If this option is not in 
effect, a unit exception is reflected to the virtual machine 
at the end of each spooled file. CONT specified for the punch 
or printer causes all CLOSE reguests to be ignored until reset 
by NOCONT. If CONT is specified, NOCONT cannot be specified. 

CONT specifies that reading is to continue, without 
intervening end-of-file indications until all files in the 
system that belong to the user are read. If CONT is not in 
effect or is reset by specification of NOCONT, an end-of-file 
indication is reflected to the virtual machine at the end of 
each SPOOL file in the system. The nature of the end-of-file 
indication to be reflected is set by the EOF and NOEOF 
options. If the EOF option is in effect, end-of-file is 
signaled by a unit exception: this corresponds to pressing 
the end-of-file button on a real card reader. If NOEOF is in 
effect for a virtual reader, end-of-file is signaled by the 
reflection of a unit check/intervention reguired status. 

NOCONT resets the continuous spooling option. If NOCONT is specified, 
CONT cannot be specified. 

HOLD places all files created by the specified device in a user 
hold status. For READER files, this option specifies that 
input files for the specified reader are not deleted from the 
system after they are read. The status of all files must be 
changed by the CHANGE command. The status of output devices is 
changed by the SPOOL command. If HOLD is specified, NOHOLD 
cannot be specified. 

If the HOLD option is specified for a virtual printer or punch 
that is transferred to a user for input (TO userid) , that 
virtual device places a user hold status on the reader file. 
The user receiving the file cannot read its status until it is 
changed by issuing the CHANGE command with the NOHOLD operand. 
The spool file class of the virtual output device must match 
the class of the receivers virtual reader (or the virtual 
reader must have a class of *) in order for the spool file to 
be processed. If these conditions are not satisfied, the 
reader appears empty to the virtual machine attempting to read 
a file, even though reader files do exist. 
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If a virtual reader is operating with CONT and HOLD, then 
virtual reader files are saved and placed in a user HOLD 
status. The file cannot be read until it is changed (using 
the CHANGE command) to a NOHOLD status. 

NOHOLD resets the HOLD operand. Future files are not held* NOHOLD 
resets the HOLD operand in effect for the specified reader. 
This operand can be overridden for an active file being closed 
by the CLOSE command using the HOLD or NOHOLD operand. If 
NOHOLD is specified, HOLD may not be specified. 

EOF sets a virtual end-of-file condition on the specified reader, 
thereby ensuring that a unit exception condition is reflected 
on the read that follows the reading of the last card in a 
file. If EOF is specified, NOEOF may not be specified. 

NOEOF specifies that the reading continues to physical end-of-file. 
The virtual reader stops when no cards are left in the reader 
and when a unit check/intervention reguired status is 
pending. If NOEOF is specified EOF may not be specified. 

[TO] userid 
* 
SYSTEM 

transfers the output of the virtual device to the virtual card 
reader of the specified userid. If TO is omitted, the userid 
may not be TO or T. TO * may be coded if the output is to be 
transferred to your own virtual card reader. If TO userid is 
specified, neither OFF nor FOR may be specified on the same 
command line. 

If you specify COPY with TO userid, the number of copies you 
specify has no effect on the receiver of the spool file; he 
receives only one copy. However, if OFF or FOR are specified 
on a subsequent command, the receiver of your spool file 
receives the number of copies you specify via COPY. For 
example, if the following command is entered: 

SPOOL PUN TO USERA COPY 3 CLASS B 

the COPY operand has no effect on the file going to USERA. 
However, if the command: 

SPOOL PUN OFF 

— or -- 

SPOOL PUN FOR USERA 

is entered, the COPY 3 specified in the first statement will 
affect subseguent punch files. 

TO SYSTEM is equivalent to specifying OFF and resets the 
transferred spool option. 



FOR userid 

indicates the userid under which printed or punched output is 
produced. The userid becomes the owner of the output spool 
file and the distcode on the file is the distcode for the user 
that is specified in the VM/370 directory. The file is not 
transferred to the user's reader input. The default setting is 
for your own virtual machine identification. FOR *, or FOR 
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SYSTEM can be coded to specify your own identification and is 
equivalent to the OFF option. 



OFF 



resets the transferred spool option. 



COPY nn is the number of copies that are to be printed or punched when 
the file is spooled to the real unit record device. This 
operand is valid only for output files; the number of copies, 
nn must be between 1 and 99 (leading zeros need not be 
specified) . 

CLOSE closes the specified device regardless of the CONT setting for 
the device. If CLOSE is specified, PURGE may not be 
specified. CLOSE does not affect the setting of any other 
operand and is provided as a convenience to close a virtual 
output device. As an example, this sequence of commands: 

SPOOL PRT CONT 

(print file) 

(print file) 

(print file) 
SPOOL PRT NOCONT 
CLOSE PRT 
SPOOL PRT CONT 

(print file) 

(print file) 



can be replaced with the following sequence to achieve the 
desired result: 

SPOOL PRT CONT 

(print file) 

(print file) 

(print file) 
SPOOL PRT CLOSE 

(print file) 

(print file) 



PURGE closes and purges the spool file from the specified virtual 
output device regardless of the CONT setting for the device. 
If PURGE is specified, CLOSE cannot be specified. PURGE does 
not affect the setting of any other operand and is equivalent 
to issuing the CLOSE command for a device (or type of device) 
with the PURGE operand. This form of the SPOOL command is 
provided for your convenience. 

START places all console input and output in a spool file. Until a 
CLOSE is issued for the console, characteristics of the 
console spool file may be changed by use of the SPOOL CONSOLE 
command. After the console is closed, the file becomes a 
printer spool file whose characteristics can be changed by 
issuing the CHANGE PRINTER command. 
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STOP terminates the spooling of console input and output. The 
command SPOOL CONSOLE STOP does not close the console spool 
file. 

TERM displays the virtual console input and output at the terminal 
in addition to placing it in a spool file. The TERM operand 
has no effect until the START operand is specified. 

NOTERM suppresses the display of console input and output of a system 
running in a virtual machine. The display of console input 
and output is not suppressed if: 

• it is the result of CP commands entered from CP mode. 

• it is the result of Commands entered on a 3270 in CMS EDIT 
mode. 

• the output line immediately precedes a virtual machine read 
to the console. (This output line will be printed twice in 
the spooled console file) . 

The NOTERM operand has no effect until the START operand is 
specified. 



!§236 Notes 



Unless otherwise set, the following options are default values for spool 
files: 



Spool File | Default Options 



Reader 

Printer 
Punch 

Console 



NOHOLD NOCONT CLASS ** EOF 

NOHOLD NOCONT CLASS A* OFF COPY 01 

NOHOLD NOCONT CLASS T* OFF COPY 01 TERM 



1 These are default classes only if a specific class option is not 
part of the VM/370 directory entry. 



The Spoolid Number: An Identifier for Your Spool Files 

Once you close a spool file by issuing the CMS PRINT or PUNCH command or 
the CP CLOSE command, CP assigns the spool file a number between 1 and 
9900. This number is called the spoolid (spool file identification) for 
the file. It can be used as a convenient way to identify the file. It 
can also be used when you are manipulating the file with VM/370 spooling 
commands such as ORDER, CHANGE or CLOSE. 

Spoolids are assigned to all your spool files seguentially . When the 
maximum number (9900) is assigned, CP begins again with the number 1. 

When you print or punch a file, CP displays at your terminal the 
spoolid it assigned to your file. You can find out various kinds of 
information about a file using the spoolid with the many forms of the 
QUERY command. 
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Transmitting Files to Remote Locations 

To direct files to remote stations, use the CP TAG and SPOOL commands in 
conjunction with a command that causes the file to be closed and sent to 
a virtual device (for example, a virtual printer or punch) . Use the TAG 
command to specify the device to be spooled and to associate with that 
device the location identifier (locid) for the destination of the file: 

TAG DEV device locid 

where device is the virtual device type (for example, PRINTER or PUNCH) 
or virtual device address (vaddr) and locid is the name of the 
destination to which the file is to be transmitted. 

Use the SPOOL command to specify that output to the device specified 
in the command is to be sent to the RSCS virtual machine, which performs 
the actual transmission of the file: 

SPOOL device TO userid 

where device is the same virtual device type or virtual device address 
specified in the TAG command and userid is the userid of the RSCS 
virtual machine at your installation. You can find out the userid of 
your installation's RSCS virtual machine and the locid for the various 
remote stations from your installations's system programmer. 

After you issue the TAG and SPOOL commands, use a command (such as 
the CMS PRINT or PUNCH command or the CP CLOSE command) to cause the 
spool file to be generated, closed, and spooled to the specified virtual 
device. 

The following example shows how to use these three commands to 
transmit a CMS file to a remote location: 

TAG DEV PUNCH CAMBRIDG 

SPOOL PUNCH TO NET 

PUNCH MYPROG ASSEMBLE 

The TAG command defines the type of file to be transmitted, a punch 
file, and the remote station to which you want it transmitted, 
CAMBRIDG. NET is the userid of the virtual machine controlling the RSCS 
network: you direct your file to that virtual machine with the SPOOL 
command. The PUNCH command causes the file MYPROG ASSEMBLE to be 
punched on your virtual machine card punch, closed, and then spooled to 
the virtual reader of the RSCS virtual machine, which you specified in 
the SPOOL command. The RSCS virtual machine then processes your file 
(now a VM/370 spool file) and transmits it across the RSCS network. 



Receiving Files from the RSCS Network 

If your virtual machine is logged on VM/370, RSCS notifies you of the 
arrival of a file for your machine from the RSCS network by displaying a 
message at your terminal. The file is sent to your virtual card reader. 

VM/370 can accumulate files from the RSCS network destined for your 
virtual card reader, regardless of whether you are logged on your 
virtual machine or not. If you are logged on your virtual machine, 
issue the QUERY command to see if you have any files in your virtual 
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reader. when you log on your virtual machine, the logon process 
transmits a message informing you of accumulated spool files residing in 
your virtual reader (punch or printer) . 



Responses 

If the SPOOL command is used to close an output device, the message 



PRT } 

PON > FILE spoolid 

CON ) 



/TO ) userid COPY nn / HOLD } 
t FOR J JNOHOLDJ 



is received if (1) multiple copies of the file are being processed, (2) 
the file is being transferred to another user, or (3) the file is placed 
in a user hold status. However, if the SET MSG option is OFF, this 
message is not issued, even though the above conditions are met, 
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STORE 



lEixii^fle Class: G 



Use the STORE command to alter the contents of specified registers and 
locations of the virtual machine. The contents of the following can be 
altered: 

• Virtual storage locations (1st level virtual storage only; see Usage 
Notes) 

• General registers 

• Floating-point registers 

• Control registers (if available) 

• Program status word 

The STORE command can also save virtual machine data in low storage. 
The format of the STORE command is: 



STore 



hexloc 
Lhexloc 

Shexloc 

/Greg\ 
\XregJ 

{Yreg} 

Psw 

STATUS 



hexwordl [ hexword2. . . ] 
hexdata. . . 

hexwordl [ hexword2. . . ] 
hexdwordl [ hexdword2. . . ] 
[hexwordl] hexword2 



where : 

hexloc 

Lhexloc hexwordl [ hexword2. . . ] 

stores the specified data (hexwordl [ hexword2. . . ]) in 
successive fullword locations starting at the address 
specified by hexloc. The smallest group of hexadecimal values 
that can be stored using this form is one fullword. Either 
form (hexloc or Lhexloc) can be used. 

If hexloc is not on a fullword boundary, it is rounded down to 
the next lower fullword. 

hexwordl [hexword2. . . ] 

each represents up to sixteen hexadecimal digits. If the 
value being stored is less than a fullword (eight 
hexadecimal digits) , it is right-adjusted in the word and 
the high order bytes of the word are filled with zeros. 
If two or more hexwords are specified, they must be 
separated by one or more blanks. 

Shexloc hexdata... 

stores the data specified (hexdata...) in the address 
specified by hexloc, without word alignment. The shortest 
string that can be stored is one byte (two hexadecimal 
digits) . If the string contains an odd number of characters, 
the last character is not stored, an error message is sent, 
and the function is terminated. 
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hexdata. . . 

is a string of two or more hexadecimal digits with no 
embedded blanks. 

Greg hexword! [ hexword2 . . . ] 

stores the hexadecimal data (hexwordl [ hexword2. . . ]) in 
successive general registers starting at the register 
specified by reg. The reg operand must be either a decimal 
number from 0-15 or a hexadecimal digit from 0-F. 

hexwordl [hexword2. . . ] 

each represents up to eight hexadecimal digits. If the 
value being stored is less than a fullword (eight 
hexadecimal digits) , it is right-adjusted in the word and 
the high order bytes of the word are filled with zeros. 
If two or more hexwords are specified, they must be 
separated by one or more blanks. 

Xreg hexwordl [ hexword2 . . . ] 

stores the hexadecimal data (hexwordl [ hexword2. . . ]) in 
successive control registers starting at the register 
specified by reg. The reg operand must either be a decimal 
number from 0-15 or a hexadecimal digit from 0-F. If the 
virtual machine is in basic control mode, you can store data 
in register only. 

hexwordl [hexword2. . . ] 

each represents up to eight hexadecimal digits. If the 
value being stored is less than a fullword (eight 
hexadecimal digits) , it is right-adjusted in the word and 
the high order bytes of the word are filled with zeros. 
If two or more hexwords are specified, they must be 
separated by one or more blanks. 

Yreg hexdwordl [ hexdword2. . . ] 

stores the hexadecimal data (hexdwordl [ hexdword2. . . ]) in 
successive floating— point registers starting at the register 
specified by reg. The reg operand must be a digit from 0—7. 
If reg is an odd number, it is adjusted to the preceding even 
number. 

hexdwordl [ hexdword2. . . ] 

each represents up to sixteen hexadecimal digits. If the 
value being stored is less than a doubleword (sixteen 
hexadecimal digits) , it is left justified in the 
doubleword and low order positions are filled with zeros. 
If two more more hexdwords are specified, they must be 
separated by one or more blanks. 

PSW [hexwordl] hexword2 

stores the hexadecimal data in the first and second words of 
the virtual machined program status word (PSW) . If only 
hexword2 is specified, it is stored into the second word of 
the PSW. 

[hexwordl] hexword2 

each represents up to eight hexadecimal digits. These 
operands must be separated by one or more blanks. If the 
value being stored is less than a fullword (eight 
hexadecimal digits) , it is right-adjusted in the word and 
the high order bytes of the word are filled with zeros. 

STATUS stores selected virtual machine data in certain low storage 
locations of the virtual machine, simulating the hardware 
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store status facility. These locations are permanently 
assigned locations in real storage. To use the STATUS 
operand, your virtual machine must be in the extended control 
mode. The STATUS operand should not be issued for CMS virtual 
machines or for DOS virtual machines generated for a CPU 
smaller than a System/360 Model 40. The STATUS operand stores 
the following data in low storage: 

Decimal Hexadecimal Length 

Address Address iB_B^tes Data 

216 D8 8 CPU Timer 

224 E0 8 Clock Comparator 

256 100 8 Current PSw 

352 160 32 Floating-point registers 0-6 

384 180 64 General registers 0-15 

448 1C0 64 Control registers 0-15 



1. Only first level storage (storage that is real to the virtual 
machine) can be stored into. Operating systems such as DOS/VS and 
OS/VS have virtual storage of their own. This second level virtual 
storage cannot be stored into directly. The user or the virtual 
operating system is responsible for converting any second level 
storage locations to first level storage 

2. The operands may be combined in any order desired, separated by one 
or more blanks, for up to one full line of input. If an invalid 
operand is encountered, an error message is issued and the store 
function is terminated. However, all valid operands entered, 
before the invalid one, are processed properly. 

3. If you combine the operands for storing into storage, registers, 
the PSW, or the status area on a single command line, all operands 
must be specified; default values do not apply in this case. 

4. If the STORE command is used by your virtual machine to alter the 
contents of a shared segment, your virtual machine will be placed 
in non-shared mode with your own copy of the shared segment. A 
fresh copy of the shared segment is then loaded for use by the 
other users. 

5. With the STORE command, data is stored either in units of one word 
with fullword boundary alignment or in units of one byte without 
alignment. 

6. The STORE STATUS command stores data in the extended logout area. 
The STORE STATUS command stores CPU Timer and Clock Comparator 
values that may then be displayed at the terminal via the DISPLAY 
command. The procedure is the only way to get timer information at 
the terminal. 



Response 

STORE COMPLETE 

is the response at the successful completion of the command. 
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Privilege Class: G 

Use the SYSTEM command to simulate the action of the RESET and RESTART 
buttons on the real computer console, and to clear storage. The format 
of the SYSTEM command is: 



| SYStem | ( CLEAR ' 
i | I RESET 

1 I I RESTART 1 






where: 



CLEAR clears virtual storage and virtual storage keys to binary 
zeros. 

RESET clears all pending interruptions and conditions in the virtual 
machine. 

RESTART simulates the hardware system RESTART function by storing the 
current PSH at virtual location eight and loading, as the new 
PSH, the doubleword from virtual location zero. Interrupt 
conditions and storage remain unaffected. 

Usage Notes 

1. The RESET function and the CLEAR function leave the virtual machine 
in a stopped state. 

2. After issuing the SYSTEM command with RESET or CLEAR specified, 
either STORE a PSH and issue BEGIN or issue BEGIN with a 
hexadecimal storage location specified, to resume operation. The 
virtual machine automatically restarts at the location specified in 
the new PSH (which is loaded from the doubleword at location zero) 
after the SYSTEM RESTART command is processed. 



Responses 

STORAGE CLEARED - SYSTEM RESET 

is the response given if the command SYSTEM CLEAR is entered. 

SYSTEM RESET 

is the response given if the command SYSTEM RESET is entered. 

If the command SYSTEM RESTART is entered, no response is given; the 
virtual machine resumes execution at the address in the virtual PSH 
loaded from virtual storage location zero. 
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lEizilese Class: G 



Use the TAG command to associate file descriptive information with a 
VM/370 spool file. The format of the TAG command is: 




{Printer 
POnch 
CONsole I [tagtext ] 
vaddr 

FILE spoolid [tagtext] 



DEv 



QUery 



Printer 
PUnch 
CONsole 
vaddr 



FILE spoolid 



where : 

DEV /PRINTER 
PRT 

'punch 

|PCH 

CONSOLE 

,vaddr 

specifies a spooling 

with the 

gueried. 



device whose output is to be associated 
tag information or whose tag information is to be 



FILE spoolid 

specifies a previously closed spool file whose tag information 
is to be replaced or gueried. This form of the TAG command 
can only be used for reader spool files that are gueued on 
your virtual reader. 

The spoolid operand is the spool file identification, a number 
between 1 and 9900 and assigned by CP when the spool file was 
closed. 

tagtext is the information (up to 136 characters in length, including 
imbedded blanks) that is to be associated with the specified 
spool device or spool file. The contents and format of this 
data is completely flexible and is the responsibility of the 
file originator and the end user. 

Certain control and addressing information, meaningful to the 
RSCS component of VM/370, can be specified in this field. For 
details on how to use the tagtext operand when transmitting 
files across the RSCS network, refer to the following "Usage 
Notes" section. 
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PRINTER 
PRT 
DEV j PUNCH 
PCH 

CONSOLE 
QUERY J \ vaddr 

FILE spoolid 



displays, at your terminal, the current tag information 
associated with a given virtual device or spool file. The 
operands used with the TAG QUERY command correspond to the 
operands used with TAG itself. 



Usage Notes 

1. The RSCS control program interprets the tag information as being 
addressing and control parameters. When you spool a file to the 
RSCS virtual machine to be transmitted to a remote station, code 
the tagtext operand as follows: 

locid [userid] [priority] 

where : 

locid is the location identifier (one to eight alphameric 
digits) of the location to which the file is being 
transmitted. Your system programmer can give you the 
locids of remote stations accessible to your virtual 
machine. 

userid is the userid of the VM/370 virtual machine (a one- to 
eight-character user identification) to which a file is 
being transmitted. This operand is used by remote 
stations when they transmit files to the RSCS virtual 
machine and want the files sent to a particular VM/370 
virtual machine. You can ignore this operand if you are 
not specifying a priority. However, if you are specifying 
a priority, you must code some userid operand; it will be 
ignored by RSCS. 

priority is the reguested transmission priority, a decimal number 
between and 99. The highest transmission priority is 0, 
next highest is 1, and so on. If you wish to specify 
this operand, you must also specify a userid operand. 

2. If you enter the TAG command with no tagtest information, the tag 
area associated with the device or file is set to all blanks. 

3. A spool file that you have created and spooled to another virtual 
machine is owned by the other user as soon as the file is closed. 
If you want to guery or change the tag data, you must first reclaim 
the file via the TRANSFER command. 
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(printer) 

tag query dev < punch > 

(console ) 

Displays the contents of the tags associated with each device of the 
specified class, as follows: 

!PRT ) n repeated for 

PUN / vaddr TAG: | each device in 

CONS; I the specified 

tagtext | class 

j 

TAG QUERY DEV vaddr 

Displays the contents of the tag associated with the specified device, 
as follows: 

( PRT ) 

<( PUN > vaddr TAG: 

( CONS) 

tagtext 

if tag data exists 

TAG NOT SET 

if the TAG command was never issued to that device. 

TAG QUERY FILE spoolid 

Displays the contents of the tag associated with the specified file, as 
follows: 

tagtext 

if tag data exists 

(TAG BLANK) 

if the tag is all blanks 

(TAG MISSING) 

if the file did not contain a tag because it was either 
an input file from the real card reader or was an output 
file generated prior to VM/370 Release 2 PLC 11. 
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TERMINAL 



££±Xiieae Class: G 



Use the TERMINAL command to control the following functions associated 
with your virtual console: 

• Logical line-editing symbols 

• Masking of password 

• The APL character set 

• signaling of an attention interruption 

• Attention handling mode for your virtual console 

• Line length for output on your virtual console 

The format of the TERMINAL command is: 



TERMinal 



C Hard el 


(ON 


LINEDel 


1 OFF 


LINENd 


( char 


EScape 




Mask 


{oFf } 


APL 


ATtn 





MODE 



LINESize 



&} 



nnn 



1 More than one function can be specified in a single entry of the 
TERMINAL command. For example: 



TERMINAL CHARDEL OFF MASK ON LINESIZE 90 






where: 



CHARDEL 




defines the logical character delete symb 
is specified, the default symbol becomes 
character delete symbol. The default symb 
a, but depends on what is specified in 
directory entry. If OFF is specified 
character delete symbol is allowed. If char 
that character (which must be a speci 
becomes the logical character delete symb 
log on, CHARDEL ON is in effect; if your v 
is logged on by the system operator vi 
command, CHARDEL OFF is the default. 



ol. If ON is 

the logical 

ol is normally 

your VM/370 

, no logical 

is specified, 

al character) 

ol. When you 

irtual machine 

a the AUTOLOG 
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LINEDEL CON ) defines the logical line delete symbol. If ON is 
specified, the default symbol becomes the logical line 
delete symbol. The default symbol is normally I, but 
depends on what is specified in your VM/370 directory 
entry. If OFF is specified, no logical line delete 
symbol is allowed. If char is specified, that character 
(which must be a special character) becomes the logical 
line delete symbol. When you leg on, LINEDEL ON is in 
effect; if your virtual machine is logged on by the 
system operator via the AUTOLOG command, LINEDEL OFF is 
the default. 

LINEND rON J defines the logical line end symbol. If ON is 
) OFF > specified, the default symbol becomes the logical line 
( charj end symbol. The default symbol is normally #, but 
depends on what is specified in your VM/370 directory 
entry. If OFF is specified, no logical line end symbol 
is allowed. If char is specified, that character (which 
must be a special character) becomes the logical line end 
character. When you log on, LINEND ON is in effect; if 
your virtual machine is logged on by the system operator 
via the AUTOLOG command, LINEND OFF is the default. 

ESCAPE (ON ) defines the logical escape character. If ON is specified, 
the default symbol becomes the logical escape character. 
The default symbol is normally ", but depends on what is 
specified in your VM/370 directory entry. If OFF is 
specified, no logical escape character is allowed. If 
char is specified, that character (which must be a 
special character) becomes the logical escape character. 
When you log on, ESCAPE ON is in effect; if your virtual 
machine is logged on by the system operator via the 
AUTOLOG command, ESCAPE OFF is the default. 

MASK f ON \ controls the typing of a mask line at a typewriter 
\OFFj terminal that is not eguipped with the print inhibit 
feature, when a password is to be entered. If MASK ON is 
specified, VM/370 types the mask line. If MASK OFF is 
specified, the mask line is not typed and it is up to 
each user to preserve the security of his password. The 
MASK operand does not apply to the IBM 3215 Console 
Printer -Key board or to similar system console or display 
terminals that do not have a print inhibit feature. 
Unless otherwise specified, MASK OFF is in effect. 

APL (ON } controls the use of APL character translation tables. 
\OFFj If APL ON is specified, CP uses the translation tables 
for display stations equipped with the APL hardware 
feature and for typewriter terminals equipped with the 
standard APL typing element. APL ON also applies to the 
3767 terminal equipped with the APL alternate character 
selection. If APL OFF is specified, CP uses the normal 
translation tables (that is, BCD or correspondence 
code) . Unless otherwise specified, APL OFF is in 
effect. 

Note: This operand is not valid for a terminal connected 
to a 3701/3705 device in NCP mode or in the NCP portion 
of PEP mode. 
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If APL ON is specified, the LINESIZE value is overridden 
(see the explanation for the LINESIZE operand, below) . 

ATTN ION ) controls signaling of an attention interruption. If ATTN 
I. OFF J ON is specified, the exclamation point is displayed when 
an an attention interruption occurs. The OFF option 
suppresses the displaying of the exclamation point (!) 
and carrier return for those systems that perform special 
line editing using the Attention key. Unless otherwise 
specified, ATTN ON is in effect. 

Note: The ATTN operand is not valid for display type 
terminals. 



m 



MODE /CP\ controls the terminal attention environment. CP specifies 
that one or more attentions force the virtual machine 
into the CP environment. VM specifies that one attention 
is reflected to your virtual machine and that more than 
one attention forces your virtual machine into the CP 
environment. VM is the default for all VM/370 users 
except the primary system operator. For more information 
on this, see "Interrupting the Execution of a Command" in 
Section 2. 

LINESIZE nnn specifies the maximum allowable line length for terminal 
output, nnn can be a number from 1 through 255. 

Note: If APL ON is specified, CP does not separate output 
lines into LINESIZE segments. Instead, an output length 
of 1760 is allowed and CP assumes that the APL system has 
inserted the appropriate carriage control characters. 



1. The terminal settings you specify with the TERMINAL command are in 
effect only for the duration of that terminal session. Whenever you 
initially log on, the system defaults are in effect. However, the 
settings you specify for line-editing and MODE are still in effect 
when you log on after disconnecting. All the other operands (MASK, 
APL, ATTN, and LINESIZE) are reset if you log on after 
disconnecting. 

2. Although you can define line-editing symbols and status with the 
TERMINAL command, the LINEDIT operand of the SET command determines 
whether the VM/370 line-editing functions are on or off. 

3. If an error occurs during processing of the command, all functions 
preceding the one with the error are in effect. 

4. You can not use any of the letters, A through Z, as a symbol (char) 
in association with any of the CHARDEL, LINEDEL, LINEND, and ESCAPE 
operands. 



5.£§E°Q§ies 



None. 
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TRACE 



TRACE 



Elivilege Class: G 



Use the TRACE command to trace specified virtual machine activity and to 
record the results at the terminal, on a virtual spooled printer, or on 
both terminal and printer. The format of the TRACE command is: 



TRace 



PRINter 

r i r n 

I IE RMinal | | NORun | 

|BOTH | |RUN | 

L J L J 



OFf 



SVC 

I/O 

PROgram 

EXTernal 

PR IV 

SIO 

CCW 

BRanch 

INSTruct 

ALL 

CSW 

END 

1 More than one of these activities may be traced by using a single 
TRACE command. For example: 

TRACE SVC PROGRAM SIO PRINTER 



i 



wh er e : 
SVC 

I/O 

PROGRAM 
EXTERNAL 
PRIV 
SIO 

CCW 

BRANCH 
INSTRUCT 
ALL 
CSW 



traces virtual machine SVC interruptions. 

traces virtual machine I/O interruptions. 

traces virtual machine program interruptions. 

traces virtual machine external interruptions. 

traces all virtual machine non-I/O privileged instructions. 

traces TIO, CLRIO, HIO, HDV, and TCH instructions to all 
virtual devices. Also traces SIO and SIOF instructions for 
nonconsole and nonspool devices only. 

traces virtual and real CCWs for nonspool nonconsole device 
I/O operations. When CCW tracing is reguested, SIO and TIO 
instructions to all devices are also traced. 

traces virtual machine interruptions, PSW instructions, and 
successful branches. 

traces all instructions, virtual machine interruptions, and 
successful branches. 

traces all instructions, interruptions, succesful branches, 
privilege instructions, and virtual machine I/O operations. 

provides contents of virtual and real channel status words at 
I/O interruption. 
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TRACE 

END terminates all tracing activity and prints a termination 
message. 

PRINTER directs tracing output to a virtual spooled printer. 

TERMINAL directs tracing output to the terminal (virtual machine 
console) . 

BOTH directs tracing output to both a virtual spooled printer and 
the terminal. 

OFF halts tracing of the specified activities on both the printer 
and terminal. 

U .**!*]! stops program execution after the trace output to the terminal 
and enters the CP command environment. 

Note: If a Diagnose code X'OOS' is being traced, NORUN has no 
effect and program execution does not stop. 

RUN continues the program execution after the trace output to the 
terminal has completed and does not enter the CP command 
environment. 



1. If your virtual machine has the virtual=real option and NOTRANS set 
on, CP forces CCW translation while tracing either SIO or CCW. When 
tracing is terminated with the TRACE END command, CCW translation 
is bypassed again. 

2. If the virtual machine assist feature is enabled on your virtual 
machine, CP turns it off while tracing SVC, PRIV, BRANCH, INSTRUCT, 
or ALL activities. After the tracing is terminated with the TRACE 
END command line, CP turns the assist feature on again. 

3. If trace output is being recorded at the terminal, the virtual 
machine stops execution and CP command mode is entered after each 
output message. This simulates the instruction step function. 

| However, all processing associated with the event being traced 
| will be completed and, therefore, execution may have stopped after 
J an instruction has executed and the PSW has been updated. 

| For example, a privileged instruction traced with the PRIV 

J operand will stop after the privileged instruction executes, 

| whereas the same instruction traced with the ALL operand will stop 

J before the instruction executes. 

| To determine whether the traced instruction has executed, 
J display the virtual machine PSW. 

To resume operation at the virtual machine, the BEGIN command 
must be entered. If the RUN operand is specified, the virtual 
machine is not stopped after each output message. 

4. If trace output is being recorded on a virtual spooled printer, a 
CLOSE command must be issued to that printer in order for the trace 
output to be printed on the real printer. 

5. Successful branches to the next sequential instruction and 
ibranch-to-self instructions are not detected by TRACE. 
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TRACE 



10 



11 



Instructions that modify or examine the first two bytes of the next 
sequential instruction cause erroneous processing for BRANCH and 
INSTRUCT tracing. 

When tracing on a virtual machine with only one printer, the trace 
data is intermixed with other data sent to the virtual printer. To 
separate trace information from other data, define another printer 
with a lower virtual address than the previously defined printer. 
For example, on a system with 00E defined as the only printer, 
define a second printer as 00B. The regular output goes to 00E and 
the trace output goes to 00B. 

If the BRANCH, INSTRUCT, or ALL activities are being traced by a 
virtual machine using a shared system, the virtual machine is 
placed in nonshared mode with its own copy of the shared segment. 
A fresh copy of the shared segment is then loaded for use by the 
other users. 

I/O operations for virtual channel-to-channel adapters, with both 
ends connected to the same virtual machine, cannot be traced. 

Use the TRACE command to trace specified virtual machine activity 
and to record the results at the terminal, at a virtual printer, or 
at both. This command is useful in debugging programs because it 
allows you to trace only the information that pertains to a 
particular problem. 

If your virtual machine is doing I/O that results in program 
controlled interruptions (PCIs) , and you are tracing I/O or CSH 
activity, some of the PCIs may not be traced. This situation 
arises when the system is extending its free storage area and the 
additional demand on available free storage would cause a system 
abend. 



Responses 



The following symbols are used in the responses received from TRACE: 



Symbol 
www 
tttttt 
rrrrrr 
xxxxxxxx 

yyyyyyyy 

ss 
ns 
zz 

zzzzzzzz 
type 

V vadd 

R radd 

mnem 

int 

code 

CC n 

IDAL 

*** 

... 



Meaning 

virtual storage address 

virtual transfer address or new PSW address 

real storage address 

virtual instruction, channel command word, CSH status 

real instruction, CCH 

argument byte (SSM-byte) for SSM instruction 

new system mask after execution of STOSM/STNSM 

low order byte of R1 register in an execute instruction 

(not shown if R1 register is register 0) 
referenced data 
virtual device name (DASD, TAPE, LINE, CONS, RDR, 

PRT, PUN, GRAF, DEV) 
virtual device address 
real device address 
mnemonic for instruction 
interruption type (SVC, PROG, EXT, I/O) 
interruption code number (in hexadecimal) 
condition-code number (0, 1, 2, or 3) 
Indirect data address list 
virtual machine interrupt 
privileged operations 
transfer of control 
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TRACE 

TRACE STARTED 

This response is issued when tracing is initiated. 

TRACE ENDED 

This response is issued when tracing is suspended. 

TCH, TIO, CLRIO, H 10 , HDV, S 10 , or SIOF 

TCH 

I/O vvvvvv TCH xxxxxxxx type vadd CC n 

TIO, CLRIO, Hip, or HDV 

I/O vvvvvv mnem xxxxxxxx type vadd CC n type radd CSW xxxx 

Sip or SIOF 

I/O vvvvvv mnem xxxxxxxx type vadd CC n type radd CSW xxxx CAW vvvvvvvv 

CCW: 

ccw vvvvvv xxxxxxxx xxxxxxxx rrrrrr yyyyyyyy yyyyyyyy 
CCW IDAL vvvvvvvv vvvvvvvv IDAL OOrrrrrr OOrrrrrr 
CCW SEEK XXXXXXXX xxxxxx SEEK YJIYJIYY JJY1 

The IDAL or SEEK line is included only if applicable. The virtual IDAL 
is not printed if the real CCW operation code does not match the real 
CCW. 

INSTRUCTION TRACING: 

Pr iv ileged I ns tr uc ti on : 

vvvvvv SSM xxxxxxxx ss (normal SSM) 

vvvvvv SSM xxxxxxxx ss tttttt (switch to/from translate mode) 

vvvvvv STOSM xxxxxxxx ns (normal STOSM) 

vvvvvv STOSM xxxxxxxx ns tttttt (switch to translate mode) 

vvvvvv STNSM xxxxxxxx ns (normal STNSM) 

vvvvvv STNSM xxxxxxxx ns tttttt (switch from translate mode) 

vvvvvv LPSW xxxxxxxx tttttttt tttttttt (WAIT bit on) 

vvvvvv LPSW xxxxxxxx ==> tttttttt tttttttt (WAIT bit not on) 

vvvvvv mnem xxxxxxxx (all others) 

Executed Instructions : 

vvvvvv EX xxxxxxxx zz vvvvvv mnem xxxx xxxxxxxx 

For an executed instruction, where zz (see preceding explanation of 
symbols) is nonzero, the mnemonic for the executed instruction is given 
as if the zz byte had been put into the instruction with an OR 
operation. 

Ail Other Instructions: 

vvvvvv mnem xxxxxxxx xxxx 
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TRACE 



SUCCESSFUL BRANCH: 

www mnem xxxxxxxx ==> tttttt 

INTERRUPTION (SVC* PROGRAM, or EXTERNAL) 
*** www int code ==> tttttt 

IZ2 INTERRUPTION (First line given only if "CSW" was specified) 

csw v vadd xxxxxxxx xxxxxxxx R radd yyyyyyyy yyyyyyyy 
*** www I/O vadd ==> tttttt CSW xxxx 

SEARCH TRACE: (ALL option selected) 
Entry for 'branch from' instruction 
www mnem xxxxxxxx tttttt 
Entry for 'branch to' instruction 
==> www mnem xxxxxxxxxxxx 
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TRANSFER 

TRANSFER 

RLLlXl^S§. Class: G 

Use the TRANSFER comnand to direct your input file to a specified reader 
or to reclaim virtual reader files that you spooled to another user. 
The format of the TRANSFER command is: 



r~ 



| TRANsfer | (spoolid) ([To] userid 

< CLass c > J 
I | (ALL ) j From ( userid \ 

ALL / 



"{ 



w her e :: 

spoolid is the input file to be directed to or retrieved from 

the named userid. 

CLASS c is the class of input files that are to be transferred. 

The c is a one-character alphameric field with values 
from A to Z and from to 9. 

ALL specifies that all input spool files are to be 

transferred. 

[TO] userid is the user to whom the files are to be directed. If 

the optional keyword TO is omitted, the userid may not 

be TO or T. The file is deleted from your reader if you 
use this option. 



(userid) 
(ALL J 



FROM J'userid\ is the user from whom input spool files are to be 
reclaimed. ALL may be specified to reclaim input spool 
files that were originated by your virtual machine from 
all users. 



Usage Notes 
1. The TRANSFER command does not transfer any active spool files, 

Responses 

RDR FILE spoolid TRANSFERRED /TO \ userid 



J TO 1 

\FROMJ 



where: 



spoolid is the spool file identification number of the file 
that is spooled. The number does not change. 

TO userid is the response to the user who transferred the file 
verifying that userid is the recipient of the file. 



140 IBM VM/370: CP Command Reference for General Users 



TRANSFER 



FROM userid is the response to the user who receives the 
transferred file indicating that userid is the 
sender. 

FROM userid is also the response to a user who reclaims a 
transferred file and userid is the user from whom 
the file was reclaimed. 



/ nnnn\ 
I NO J 



FILES TRANSFERRED 



is also a response you receive when you issue the TRANSFER 
command. It is not displayed if you issued the CP SET IMSG OFF 
command line. 
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Appendix A: VM/370 Command Summary 



This appendix contains brief descriptions of all the commands acceptable 
to the CP, CMS and RSCS components of the VM/370 system. 

Figure 7 contains an alphabetical list of the CP commands, the 
privilege classes which may execute the command, and a brief statement 
about the use of each command. 




ACNT 

ADSTOP 

ATTACH 

ATTN 
AUTOLOG 
BACKSPAC 
BEGIN 

CHANGE 

CLOSE 

COUPLE 
CP 

DCP 
DEFINE 



Privilege 
Class 

any 

any 



A,B 



D,G 



G 
any 

C,E 
G 



Usage 

Annotate the console sheet. 

Execute a CP command while remaining in the 
virtual machine environment. 

Create accounting records for logged on users 
and reset accounting data. 

Halt execution at a specific virtual machine 
instruction address. 

Attach a real device to a virtual machine. 
Attach a DASD device for CP control. 
Dedicate all devices on a particular channel 
to a virtual machine. 

Make an attention interruption pending for the 
virtual machine console. 

Automatically log on a virtual machine and 
have it operate in disconnect mode. 

Restart or reposition the output of a unit 
record spooling device. 

Continue or resume execution of the virtual 
machine at either a specific storage location 
or at the address in the current PSW. 

Alter one or more attributes of a closed spool 
file. 

Terminate spooling operations on a virtual card 
reader, punch, printer, or console. 

Connect channel— to-channel adapters. 

Execute a CP command while remaining in the CMS 
virtual machine environment. 

Display real storage at terminal. 

Reconfigure your virtual machine. 



Figure 7. CP Command Summary (Part 1 of 4) 
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Command 
DETACH 



DIAL 



DISABLE 


A,B 


DISCONN 


any 


DISPLAY 


G 


DMCP 


C,E 



DRAIN 
DUMP 

ECHO 

ENABLE 
EXTERNAL 

FLUSH 

FORCE 

FREE 

HALT 

HOLD 

INDICATE 
IPL 
LINK 

LOADBUF 
Figure 7. 



Privilege 
Class 



B 
B 
B 
G 
G 

any 



A r B 
G 



A 
D 
A 

D 

E,G 
G 
G 



Usage 



Disconnect a real device from a virtual machine. 

Detach a DASD device from CP . 

Detach a channel from a specific user. 

Detach a virtual device from a virtual machine. 

Detach a channel from your virtual machine. 

Connect a terminal or display device to the 
virtual machine's virtual communication line. 

Disable 2701/2702/2703, 3704/3705 in EP mode, 
and 3270 local communication lines. 

Disconnect your terminal from your virtual 
machine. 

Display virtual storage on your terminal. 

Dump the specified real storage location on your 
virtual printer. 

Halt operations of specified spool devices upon 
completion of current operation. 

Print the following on the virtual printer: 

virtual PSH, general registers, floating-point 
registers, storage keys, and contents of 
specified virtual storage locations. 

Test terminal hardware by redisplaying data 
entered at the terminal. 

Enable communication lines. 

Simulate an external interruption for a virtual 
machine and return control to that machine. 

Cancel the current file being printed or punched 
on a specific real unit record device. 

Cause logoff of a specific user. 

Remove spool HOLD status. 

Terminate the active channel program on 
specified real device. 

Defer real spooled output of a particular user. 

Indicate resource utilization and contention. 

Simulate IPL for a virtual machine. 

Provide access to a specific DASD device by a 
virtual machine. 

Load real UCS/UCSB or FCB printer buffers. 



CP Command Summary (Part 2 of 4) 
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Command 
LOADVFCB 

LOCATE 
LOCK 

LOGOFF 
LOGON 
MESSAGE 
MONITOR 

NETWORK 

NOTREADY 

ORDER 

PURGE 
QUERY 

READY 

REPEAT 

REQUEST 

RESET 

REWIND 

SAVESYS 

SET 



Privilege 
Class 



C,E 
A 

any 
any 

A,B,any 
A,E 

A,B,F 



D,G 



D,G 



A,B,C,D, 
E,F,G 



A,B,F,G 



Usage 

Load virtual forms control buffer for a virtual 
3211 printer. 

Find CP control blocks. 

Bring virtual pages into real storage and lock 
them; thus excluding them from future paging. 

Disable access to CP. 

Provide access to CP. 

Transmit messages to other users. 

Trace events of the real machine and record 
system performance data. 

Load, dump, trace and control the operation of 
the 3704/3705 control program. Control the 
operation of 3270 remote devices. 

Simulate "not ready" for a device to a virtual 
machine. 

Rearrange closed spool files in a specific 
order. 

Remove closed spool file from system. 

Request information about machine configuration 
and system status. 

Simulate device end interruption for a virtual 
device. 

Repeat (a specified number of times) printing or 
punching of a specific real spool output file. 

Make an attention interruption pending for the 
virtual machine console. 

Clear and reset all pending interruptions for a 
specified virtual device and reset all error 
conditions. 

Rewind (to load point) a tape and ready a tape 
unit. 

Save virtual machine storage contents, 
registers, and PSW. 

Operator — establish system parameters. 
User — control various functions within the 
virtual machine. 



Figure 7. CP Command Summary (Part 3 of 4) 
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Command 
SHUTDOWN 

SLEEP 
SPACE 
SPOOL 

START 

STCP 
STORE 

SYSTEM 

TAG 



TERMINAL 

TRACE 

TRANSFER 

UNLOCK 

VARY 

WARNING 

i 

Figure 7. 



Privilege 
Class 



any 
D 



D,G 

A 
B 
A r E 



Usage 



Terminate all VM/370 functions and checkpoint CP 
system for warm start. 

Place virtual machine in dormant state. 

Force single spacing on printer. 

Alter spooling control options; direct a file to 
another virtual machine or to a remote 
location via the RSCS virtual machine. 

Start spooling device after draining or changing 
output classes. 

Change the contents of real storage. 

Alter specified virtual storage locations and 
registers . 

Simulate RESET, CLEAR STORAGE and RESTART 
buttons on a real system console. 

Specify variable information to be associated 
with a spool file or output unit record 
device. 

Interrogate the current TAG text setting of a 
given spool file or output unit record device. 

Define or redefine the input and attention 
handling characteristics of your virtual 
console. 

Trace specified virtual machine activity at your 
terminal, spooled printer, or both. 

Transfer input files to or reclaim input files 
from a specified user's virtual card reader. 

Unlock previously locked page frames. 

Mark a device unavailable or available. 

Transmit a high priority message to a specified 
user or to all users. 



CP Command Summary (Part 4 of 4) 
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Figure 8 contains an alphabetical list of the CMS commands with a brief 
statement about the use of each command. Unless otherwise noted under 
Ref. Code, the CMS commands are described in the VM/370: CMS Command and 
M^cro Reference. 

Use the following chart to determine which publication contains 
reference information about the CMS commands that are not described in 
the above publication. 

Ref 
Code 

SYSGEH Described in the VM/370: Planning and System Generation 
Guide. 

OS PP Invokes an OS Program Product, available from IBM for a 
license fee. 

EREP Described in the VM/370: Environmental Recording, Editing, and 
Printing (EREP) Program. 

Op Gd Described in the VM/370: Operator's Guide. 

SCRIPT Invokes a text processor that is an IBM Installed User 
Program, available from IBM for a license fee. 

DOS PP Invokes a DOS Program Product available from IBM for a license 
fee. 

SPG Described in the VM/370: System Programmer's Guide. 

IPCS Described in the VM/370: Interactive Problem Control System 
(IPCS) User's Guide. 
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Command 
ACCESS 

AMSEHV 



| Code | 



Usage 



ASM3705 


SYSGEN 


ASSEMBLE 




ASSGN 




CMSBATCH 




COBOL 


OS PP 


COMPARE 




CONVERT 


OS PP 


COPYFILE 




CP 




CPEREP 


EREP 


DDR 


Op Gd, 




SYSGEN 


DEBUG 




DIRECT 


Op Gd, 




SYSGEN 



DISK 

DLBL 

DOSGEN 
DOSLIB 

DOSLKED 

DOSPLI 
DSERV 



SYSGEN 



DOS PP 



Identify direct access space to a CMS virtual 
machine, create extensions and relate the disk 
space to a logical directory. 

Invoke Access Method Services utility functions to 
create, alter, list, copy, delete, import, or 
export VSAM catalogs and data sets. 

Assemble 3704/3705 source code. 

Assemble Assembler Language source code« 

Assign or unassign a CMS/DOS system or programmer 
logical unit for a virtual I/O device. 

Invoke the CMS Batch Facility. 

Compile OS ANS Version 4 or OS/VS COBOL source 
code. 

Compare records in CMS disk files. 

Convert free form FORTRAN statements to fixed form. 

Copy CMS disk files according to specifications. 

Enter CP commands from the CMS environment. 

Dump error information which was recorded by VM/370 
error recording routines. 

Perform backup, restore, and copy operations for 
disks. 

Enter DEBUG subcommand environment, debug mode. 

Set up VM/370 directory entries. 



Perform disk-to-card and card-to-disk operations 
for CMS files. 

Define a DOS filename or VSAM ddname and relate 
that name to a disk file. 

Load and save the CMSDOS shared segment™ 

Delete, compact, or list information about the 
phases of a CMS/DOS phase library. 

Link-edit CMS text decks or object modules from a 
DOS/VS relocatable library and place them in 
executable form in a CMS/DOS phase library. 

Compile DOS PL/I source code under CMS/DOS. 

Display information contained in the DOS/VS core 
image, relocatable, source, procedure, and 
transient directories. 



Figure 8. CMS Command Summary (Part 1 of 4) 
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Command 

DUMPSCAN 

EDIT 

ERASE 
ESEEV 

EXEC 



ICode 
IPCS 



FCOBOL 


DOS PP 


FETCH 




FILEDEF 




FORMAT 




FORTGI 


OS PP 


FORTHX 


OS PP 


GEN3705 


SYSGEN 


GENDIRT 




GENMOD 




GLOBAL 





GOFCRT 

INCLUDE 

LISTDS 

LISTFILE 
LISTIO 

LKED 
LOAD 
LOADMOD 
MACLIB 
Figure 8. 



OS PP 



SYSGEN 



Usage 

Provide interactive analysis of CP abend dumps. 

Invoke the CMS Editor to create or modify a disk 
file. 

Delete CMS disk files. 

Display, punch or print an edited (compressed) 
macro from a DOS/VS source statement library 
(E sublibrary) . 

Execute special procedures made up of frequently 
used sequences of commands. 

Compile DOS/VS COBOL source code under CMS/DOS. 

Fetch a CMS/DOS executable phase. 

Define an OS ddname and relate that ddname to any 
device supported by CMS. 

Prepare disks in CMS 800-byte block format. 

Compile FORTRAN source code using the G1 compiler. 

Compile FORTRAN source code using the H-extended 
compiler. 

Generate an EXEC file that assembles and link— edits 
the 3704/3705 control program. 

Fill in auxiliary module directories. 

Generate non-relocatable CMS files (MODULE files) . 

Identify specific CMS libraries to be searched for 
macros, copy files, missing subroutines, or DOS 
executable phases. 

Compile FORTRAN source code and execute the program 
using the FORTRAN Code and Go compiler. 

Bring additional TEXT files into storage and 
establish linkages. 

List information about data sets and space 
allocation on OS, DOS, and VSAM disks. 

List information about CMS disk files. 

Display information concerning CMS/DOS system and 
programmer logical units. 



Link-edit the 3704/3705 control program. 
Bring TEXT files into storage for execution, 
Bring a single MODULE file into storage. 
Create or modify CMS macro libraries. 
CMS Command Summary (Part 2 of 4) 
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Command 

MODMAP 

MOVEFILE 

NCPDUMP 

OPTION 

PLIC 

PLICE 

PLIOPT 

PRB 
PRINT 
PROB 
PSERV 

PUNCH 
QUERY 
READCARD 
RELEASE 

RENAME 
RSERV 

RUN 

SAVENCP 
SCRIPT 
SET 



|Code | Usage 

Display the load map of a MODULE file. 

Move data from one device to another device of the 
same or a different type. 



Op Gd, 
SYSGEN, 
SPG 



OS PP 



OS PP 



OS PP 



IPCS 



IPCS 



SYSGEN, 
SPG 

SCRIPT 



Process CP spool reader files created by 3704/3705 
dumping operations. 



Change the DOS COBOL compiler (FCOBOL) options that 
are in effect for the current terminal session. 

Compile and execute PL/I source code using the 
PL/I Checkout Compiler. 

Execute the PL/I object code generated by the OS 
PL/I Checkout Compiler. 

Compile PL/I source code using the OS PL/I 
Optimizing Compiler. 

Update IPCS problem status. 

Spool a specified CMS file to the virtual printer. 

Enter a problem report in IPCS. 

Copy a procedure from the DOS/VS procedure library 
onto a CMS disk, display the procedure at the 
terminal, or spool the procedure to the virtual 
punch or printer. 

Spool a copy of a CMS file to the virtual punch. 

Reguest information about a CMS virtual machine. 

Read data from spooled card input device. 

Make a disk and its directory inaccessible to a CMS 
virtual machine. 

Change the name of a CMS file or files. 

Copy a DOS/VS relocatable module onto a CMS disk, 
display it at the terminal, or spool a copy to 
the virtual punch or printer. 

Initiate series of functions to be performed on a 
source, MODULE, TEXT, or EXEC file. 

Read 3704/3705 control program load into virtual 
storage and save an image on a CP— owned disk. 

Format and print documents according to embedded 
SCRIPT control words in the document file. 

Establish, set, or reset CMS virtual machine 
characteristics . 



Figure 8. CMS Command Summary (Part 3 of 4) 
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Command 
SETKEY 

SORT 

SSERV 

START 

STAT 

STATE 

STATEW 

SVCTRACE 
SYNONYM 

TAPE 

TAPEMAC 

TAPPDS 

TESTCOB 

TESTFORT 

TXTLIB 

TYPE 

UPDATE 

VMFDUMP 

VMFLOAD 
VSAMGEN 
VSBASIC 
VSBUTIL 

ZAP 



ICode 
SPG 



IPCS 



OS PP 
OS PP 



Op Gd 
IPCS 

SYSGEN 

SYSGEN 

OS PP 

OS PP 



Op Gd, 

SYSGEN, 

SPG 



Osage 

Assign storage protect keys to storage assigned to 
named systems. 

Arrange a specified file in ascending order 
according to sort fields in the data records. 

Copy a DOS/VS source statement book onto a CMS 
disk, display it at the terminal, or spool a copy 
to the virtual punch or printer. 

Begin execution of programs previously loaded (OS 
and CMS) or fetched (CMS/DOS) . 

Display the status of reported system problems. 

Verify the existence of a CMS disk file. 

Verify the existence of a file on a read/write 
CMS disk. 

Record information about supervisor calls. 

Invoke a table containing synonyms you have created 
for CMS and user— written commands. 

Perform tape-to-disk and disk-to-tape operations 
for CMS files, and position tapes. 

Create CMS MACLIB libraries directly from an 
IEHMOVE-created partitioned data set on tape. 

Load OS partitioned data set (PDS) files or card 
image files from tape to disk. 

Invoke the OS COBOL Interactive Debug Program. 

Invoke the FORTRAN Interactive Debug Program. 

Generate and modify text libraries. 

Display all or part of a CMS file at the terminal. 

Make changes in a program source file as defined 
by control cards in a control file. 

Format and print system abend dumps; under IPCS, 
create a problem report. 

Generate a new CP, CMS or RSCS module. 

Load and save the VSAM shared segment. 

Compile and execute VS BASIC programs under CMS. 

Convert BASIC 1.2 data files to the format required 
by VS BASIC. 

Modify or dump LOADLIB, TXTLIB, or MODULE files. 



Figure 8. CMS Command Summary (Part 4 of 4) 
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Figure 9 contains an alphabetical list of the RSCS commands with a brief 
statement about the use of each command. RSCS commands are described in 
the VH</370: Remote Spooling Communication^ Subsystem (RSCS) UserJ.s 
Guide. 



Command 

Name | Function 

BACKSPAC | Restart or reposition, in a backward direction, the file 
currently being transmitted. 

CHANGE j Alters one or more attributes of a file owned by RSCS. 

CMD | Control certain functions performed by a remote system, 
or control the logging of I/O activity on a specified 
link. 

DEFINE I Temporarily add a new link definition to the RSCS link 
table or temporarily redefine an existing link. 

DELETE | Temporarily delete a link definition from the RSCS link 
table. 

DISCONN | Place RSCS in disconnect mode and optionally direct 
output to another virtual machine. 

DRAIN j Deactivate an active communication link. 

FLUSH I Discontinue processing the current file on the specified 
link. 

FREE I Resume transmission on a communication link previously 
in HOLD status. 

FWDSPACE I Reposition, in a forward direction, the file currently 
being transmitted. 

HOLD | Suspend file transmission on an active link without 
deactivating the line. 

MSG | Send a message to a local or remote station. 

ORDER | Reorder files engueued on a specific link. 

PURGE I Remove all or specified files from a link. 

QUERY | Reguest system information for a link, a file, or for the 
system in general. 

START I Activate a specified communication link. 

TRACE I Monitor line activity on a specified link. 



Figure 9. RSCS Command Summary 
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described 37 
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summary 143 
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of QUERY command (CP) 95 
of TRACE command (CP) 135 
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virtual punch file 41 
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control of translation tables 132 
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ASM3705 command, summary 148 
ASSEMBLE command, summary 148 
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ATTACH command, summary 143 
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described 41 
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summary 143 
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storage to zeros 75,128 
CLOSE 

command 
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described 43 
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PRINTER operand 43 
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PURGE operand 44 
READER operand 43 
summary 143 
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DCP command, summary 143 
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DEBUG command, summary 148 
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described 49 
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PUNCH operand 49 
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summary 143 
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summary 144 
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described 59 
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summary 144 

command (RSCS) , summary 152 
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DISK command, summary 148 
DISPLAY command 

CAW operand 63 
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described 61 
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summary 144 
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extended control mode, setting 111 
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